ReddRadar
Agent skill
error-code-catalog
Manage and document SDK error codes and messages
Install this agent skill to your Project
npx add-skill https://github.com/a5c-ai/babysitter/tree/main/library/specializations/sdk-platform-development/skills/error-code-catalog
SKILL.md
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
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
a5c-ai/babysitter
gsd-tools
Central utility skill for GSD operations. Provides config parsing, slug generation, timestamps, path operations, and orchestrates calls to other specialized skills. Acts as the unified entry point that the original gsd-tools.cjs provided via its lib/ modules (commands, config, core, init).
a5c-ai/babysitter
model-profile-resolution
Resolve model profile (quality/balanced/budget) at orchestration start and map agents to specific models. Enables cost/quality tradeoffs by selecting appropriate AI models for each agent role.
a5c-ai/babysitter
verification-suite
Plan structure validation, phase completeness checks, reference integrity verification, and artifact existence confirmation. Provides the structured verification layer ensuring GSD artifacts are well-formed and complete.
a5c-ai/babysitter
state-management
STATE.md reading, writing, and field-level updates. Provides cross-session state persistence via .planning/STATE.md with structured fields for current task, completed phases, blockers, decisions, and quick tasks.
a5c-ai/babysitter
git-integration
Git commit patterns, formats, and conventions for GSD methodology. Provides atomic commits per task, structured commit messages, planning file commits, branch management, and milestone tag operations.
a5c-ai/babysitter
frontmatter-parsing
YAML frontmatter parsing and manipulation for .planning/ documents. Provides read, write, update, query, and validation operations on frontmatter blocks in GSD markdown artifacts.
Didn't find tool you were looking for?