designing-agent-error-messages
Audit and rewrite error messages, exceptions, and API/SDK/CLI failure output so an AI agent (and a human) can self-correct without leaving the terminal. Use when designing or reviewing how a tool fails — error strings, HTTP error bodies, auth/credential errors, CLI errors, thrown exceptions — especially for libraries, APIs, and CLIs that AI agents consume. Grounded in patterns from 2027.dev's evals of 136 dev tools across 3,500+ agent runs.
78
91%
Does it follow best practices?
Impact
93%
1.17x1 of 3 eval scenarios. Add 2 more for a full score.
Passed
No findings from the security scan
No security issues found
Scanned
- Repository
team2027/2027-skills
- Revision
1a9e499
- Audited
- Security analysis
Is this your skill?
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.