a5c-ai Error Code Catalog Skill
Overview
This skill manages a comprehensive catalog of SDK error codes, messages, and documentation, ensuring consistent, helpful error handling across all SDK operations.
Capabilities
- Define error code taxonomy with categories
- Generate error documentation automatically
- Validate error message quality and actionability
- Support error localization (i18n)
- Map HTTP status codes to SDK errors
- Generate error handling code from catalog
- Track error frequency and patterns
- Create troubleshooting guides per error
Target Processes
- Error Handling and Debugging Support
- API Design Specification
- API Documentation System
Integration Points
- Error tracking systems (Sentry, Bugsnag)
- i18n frameworks for localization
- Documentation generators
- SDK code generation
- Analytics platforms
Input Requirements
- Error categorization requirements
- Message style guidelines
- Localization requirements
- HTTP mapping rules
- Troubleshooting depth
Output Artifacts
- Error code catalog (JSON/YAML)
- Error documentation pages
- SDK error classes/types
- Localization resource files
- Troubleshooting guides
- Error mapping tables
Usage Example
skill:
name: error-code-catalog
context:
catalogFile: ./errors/catalog.yaml
errorFormat:
codePrefix: "SDK"
codeLength: 4
pattern: "SDK-{category}-{number}"
categories:
- auth
- validation
- network
- rate-limit
- server
localization:
enabled: true
locales: ["en", "es", "ja", "de"]
includeRemediation: true
Best Practices
- Use meaningful error code prefixes
- Include remediation steps in all errors
- Categorize errors logically
- Keep error messages actionable
- Support localization from the start
- Link errors to documentation