error-code-guide

Design standardized error codes using the PREFIX_CATEGORY_NUMBER format.

5|1|Updated Jan 14, 2026
One-click install
npx skills add https://github.com/ValorVie/custom-skills --skill error-code-guide-valorvie
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: error-code-guide
Source: https://github.com/ValorVie/custom-skills/tree/main/skills/error-code-guide
Command: npx skills add https://github.com/ValorVie/custom-skills --skill error-code-guide-valorvie

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Design consistent error codes following the PREFIX_CATEGORY_NUMBER format to unify error handling across services and improve debuggability and user experience.

Core Features & Use Cases

  • Error code format guidance (PREFIX_CATEGORY_NUMBER) for all services.
  • Examples, HTTP status mappings, and i18n keys to streamline integration.
  • Project-level registry planning and adoption guidance (including templates and checklists).

Quick Start

Create a new error code registry following the PREFIX_CATEGORY_NUMBER format and map each code to a HTTP status and i18n key.

Frequently Asked Questions about error-code-guide

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
What is the best way to standardize error codes across multiple services?

To standardize error codes, create a registry using the PREFIX_CATEGORY_NUMBER format and map each code to an HTTP status and i18n key. This unifies error handling across services and streamlines integration for validation and system failures.

How do I map standardized error codes to HTTP status codes and i18n keys?

You map standardized error codes by defining a registry that connects each PREFIX_CATEGORY_NUMBER code to appropriate HTTP statuses and i18n keys. This ensures unified handling of validation, business, and system failures across platforms.

Does this error code standardization approach work for web and mobile API design?

Yes, the standardized error code format applies to API design across web and mobile apps. It handles validation, business rules, system failures, and network issues for client-facing messaging and logging uniformly.

How do I structure a project-level error code registry for internationalization?

Structure a project-level error code registry by defining PREFIX_CATEGORY_NUMBER codes mapped to HTTP statuses and i18n keys. Include templates and checklists to guide adoption and ensure consistent internationalization across services.

What categories should I include when designing a standardized error code system?

Include categories for validation, business rules, system failures, and network issues when designing a standardized error code system. The PREFIX_CATEGORY_NUMBER format ensures consistent logging and client-facing messaging across services.