CtrlK
BlogDocsLog inGet started
Tessl Logo

writing-error-messages

Use when writing, reviewing, or rewriting user-facing error messages, validation messages, form errors, empty/error states, auth errors, failure notifications, retry/support copy, CLI errors, or API errors humans will read. Helps make errors specific, actionable, non-blaming, accessible, and safe without leaking sensitive details.

99

1.08x
Quality

100%

Does it follow best practices?

Impact

99%

1.08x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

Quality

Content

100%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is an excellent skill file that is concise, highly actionable, and well-structured. It covers a broad range of error message contexts (UI, CLI, API, security, forms) without becoming verbose, using tables and concrete examples effectively. The progressive disclosure to reference files is well-signaled, and the workflow from identification through writing to final validation is clear and complete.

DimensionReasoningScore

Conciseness

The content is lean and efficient throughout. It avoids explaining what error messages are or why they matter—concepts Claude already knows. Every section delivers actionable patterns, tables, and examples without padding. The tables are particularly token-efficient for conveying do/avoid pairs.

3 / 3

Actionability

The skill provides concrete, copy-paste-ready error message patterns, specific do/avoid examples, a reusable message template shape, and a checklist of questions to ask. The guidance is specific enough to produce consistent output across different error message scenarios.

3 / 3

Workflow Clarity

The skill establishes a clear sequence: identify audience/failure/cause/recovery → write the message shape → apply core rules → run the final check. The 'When Asked for a Generic Error' section provides a feedback loop (ask clarifying questions before accepting vague requests). The 'Final Check' section serves as an explicit validation checkpoint. For a writing/review skill (non-destructive), this level of workflow structure is thorough.

3 / 3

Progressive Disclosure

The SKILL.md provides a complete, well-organized overview with clear references to 'references/source-backed-patterns.md' and 'references/rewrite-examples.md' for deeper content. References are one level deep and clearly signaled with guidance on when to open them. Content is appropriately split between the main file and reference files.

3 / 3

Total

12

/

12

Passed

Description

100%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

This is an excellent skill description that clearly defines its scope, provides abundant natural trigger terms, and explicitly states both what it does and when to use it. The description is concise yet comprehensive, covering a wide range of error message types while specifying the quality attributes it enforces. It uses proper third-person voice and would be easily distinguishable from other skills in a large skill library.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: writing, reviewing, rewriting error messages. Also specifies quality attributes: specific, actionable, non-blaming, accessible, safe. Covers many concrete subtypes like form errors, auth errors, CLI errors, API errors.

3 / 3

Completeness

Explicitly answers both 'what' (helps make errors specific, actionable, non-blaming, accessible, and safe) and 'when' (starts with 'Use when writing, reviewing, or rewriting user-facing error messages...'). The 'Use when' clause is prominent and detailed.

3 / 3

Trigger Term Quality

Excellent coverage of natural terms users would say: 'error messages', 'validation messages', 'form errors', 'empty states', 'error states', 'auth errors', 'failure notifications', 'retry copy', 'support copy', 'CLI errors', 'API errors'. These are all terms a user would naturally use when requesting help with error UX writing.

3 / 3

Distinctiveness Conflict Risk

Clearly carved out niche focused specifically on error/failure messaging UX copy. The combination of error-specific trigger terms and the quality criteria (non-blaming, no sensitive detail leaking) makes this highly distinctive and unlikely to conflict with general copywriting or coding skills.

3 / 3

Total

12

/

12

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
joshuadavidthomas/agent-skills
Reviewed

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.