Can I use this for internationalization (i18n)?

Yes, the skill provides a standard message key format (error.prefix.category.number) to ensure consistent translations across different languages in your application.

What is the PREFIX_CATEGORY_NUMBER format?

It is a structured way to name errors where PREFIX is the service (e.g., AUTH), CATEGORY is the type (e.g., VAL for validation), and NUMBER is a unique ID (e.g., 001).

Does it support multiple validation errors in one response?

Yes, the skill defines a standardized JSON structure for returning an array of errors, which is essential for handling multiple field validation failures simultaneously.

How does this skill handle HTTP status code mapping?

It automatically associates error categories with correct HTTP codes: Validation (VAL) maps to 400, Business (BIZ) to 422, Security (AUTH) to 401/403, and System (SYS) to 500.

Is this skill compatible with TypeScript projects?

Absolutely. It includes TypeScript interface definitions for the ApplicationError object to ensure type safety when implementing error handling in your code.

Error Code Guide

Name: Error Code Guide
Author: ValorVie

byValorVie

•

API Development

Standardizes error code design and implementation using a consistent PREFIX_CATEGORY_NUMBER format for better debugging and API reliability.

The Error Code Guide skill provides a comprehensive framework for creating structured, meaningful error codes across your applications. By enforcing a unified naming convention (Prefix-Category-Number), it simplifies debugging, enhances monitoring visibility, and ensures consistent error responses for frontend consumers. This skill includes built-in mappings for HTTP status codes, specific category ranges for validation, business, and system errors, and templates for internationalization (i18n), helping developers build more maintainable and user-friendly error handling systems that scale with their architecture.

Key Features

013 GitHub stars

02Implements the universal PREFIX_CATEGORY_NUMBER naming standard

03Maps error categories to appropriate HTTP status codes (e.g., VAL to 400, BIZ to 422)

04Includes predefined code ranges for consistent categorization across services

05Supports internationalization with structured message key patterns

06Provides standardized JSON response formats for single and multi-error payloads

Use Cases

01Designing a new RESTful or GraphQL API error handling strategy

02Refactoring legacy string-based errors into a structured error registry

03Standardizing error communication between microservices and frontend clients

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add valorvie/custom-skills error-code-guide

For use in Claude.ai and ChatGPT

Download Skill