CtrlK
BlogDocsLog inGet started
Tessl Logo

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

1.17x
Quality

Does it follow best practices?

Impact

93%

1.17x

Average score across 1 eval scenario

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

Evaluation results

93%

14%

Error Message Audit: DataSync Service

Error message audit and fix workflow

Criteria
Without context
With context

Silent failure identified first

80%

100%

Silent failure rated F

0%

100%

Silent failure fixed loudly

100%

100%

Misleading error identified

100%

100%

Misleading error root cause fix

100%

100%

Removed-feature warning flagged

100%

100%

Network-blame error identified

57%

0%

A/C/F rubric applied

0%

100%

Four-question spec in fixed errors

100%

100%

Env-var name in credential error

100%

100%

URL in credential error

100%

100%

validate_api_key error improved

100%

100%

Repository
team2027/2027-skills
Evaluated
Agent
Claude Code
Model
Claude Sonnet 4.6

Table of Contents

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.