CtrlK
BlogDocsLog inGet started
Tessl Logo

error-handling-patterns

Master error handling patterns across languages including exceptions, Result types, error propagation, and graceful degradation to build resilient applications. Use when implementing error handling, designing APIs, or improving application reliability.

56

Quality

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

Quality

Content

57%

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

The body is well-structured with a clean overview pointing to a real one-level-deep reference, a complete Python example, and concrete best practices and pitfalls. Its weaknesses are conceptual padding Claude doesn't need, single-language coverage despite an 'across languages' claim, and the absence of an explicit workflow with validation checkpoints.

Suggestions

Trim the 'Core Concepts' section to essentials Claude does not already know, or move the philosophy/category taxonomy into references/details.md to save context tokens.

Add at least one non-Python example (e.g. a Rust/Golang Result/err return pattern) to back up the 'across languages' claim, or scope the description and body to 'with Python examples' to match.

Add an explicit error-handling workflow sequence with a validation checkpoint (e.g. 1. classify recoverable vs unrecoverable, 2. handle at the right layer, 3. verify context is preserved, 4. log/re-throw) so the process is sequenced rather than implied.

DimensionReasoningScore

Conciseness

Most of the body (Best Practices, Pitfalls, the code example) is efficient, but the 'Core Concepts' section explains basics Claude already knows ('Exceptions: Traditional try-catch, disrupts control flow', listing 'Network timeouts', 'Missing files' as recoverable), fitting 'mostly efficient but includes some unnecessary explanation'; not a 1 because the practical content is not padded, and not a 3 because of the conceptual filler.

2 / 3

Actionability

It provides one fully executable, copy-paste-ready Python example with typed exceptions and error wrapping, plus concrete pitfalls, but the skill claims 'across languages' while only showing Python, and the 'Core Concepts' section is descriptive rather than instructional, fitting 'some concrete guidance but incomplete'; not a 3 due to single-language coverage and descriptive sections.

2 / 3

Workflow Clarity

The numbered Best Practices and the process_order example imply a validate-then-handle sequence with implicit checkpoints, but the skill has no explicit sequenced workflow with validation/feedback steps at the instruction level, fitting 'sequence present but checkpoints missing or implicit'; not a 3 because there is no explicit validation checkpoint checklist for the skill's own process.

2 / 3

Progressive Disclosure

SKILL.md is a concise overview and clearly signals a one-level-deep reference ('Detailed pattern documentation lives in references/details.md. Read that file when the navigation tier above is insufficient.'); the referenced file exists and is one level deep, matching 'clear overview with well-signaled one-level-deep references'; not lower because navigation is explicit and the split is appropriate.

3 / 3

Total

9

/

12

Passed

Description

67%

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

The description clearly answers both what the skill does and when to use it with an explicit 'Use when' clause, and stays in third person. It is weakened by topic-style rather than action-style specificity, limited trigger term variation, and broad secondary triggers that raise conflict risk.

Suggestions

Replace topic-list framing with concrete actions, e.g. 'Implement try/catch flows, typed Result values, retry and circuit-breaker logic, and graceful degradation across languages.'

Add natural trigger variations users actually say, such as 'exception handling', 'try-catch', 'retry logic', and 'circuit breakers', alongside the existing 'error handling'.

Tighten the broad triggers: drop or scope 'designing APIs' and 'improving application reliability' to error-specific contexts (e.g. 'designing error-resilient APIs') to reduce overlap with other skills.

DimensionReasoningScore

Specificity

It names the domain ('error handling patterns across languages') and lists patterns ('exceptions, Result types, error propagation, and graceful degradation'), but these are topics rather than concrete executable actions like 'extract text' or 'fill forms', matching the 'names domain and some actions' anchor; it is not a 3 because no multiple specific concrete actions are listed.

2 / 3

Completeness

It explicitly answers what ('Master error handling patterns... to build resilient applications') and when with an explicit 'Use when implementing error handling, designing APIs, or improving application reliability' trigger clause, matching the 'clearly answers both what AND when' anchor; the Use when clause is present so it is not capped at 2.

3 / 3

Trigger Term Quality

The natural term 'error handling' appears and triggers ('implementing error handling, designing APIs, improving application reliability') are reasonable, but common variations users would say (e.g. 'exception handling', 'try-catch', 'retry', 'circuit breaker') are absent, fitting 'some relevant keywords but missing common variations'; not a 3 due to limited variation coverage.

2 / 3

Distinctiveness Conflict Risk

'error handling patterns' is a recognizable niche, but the secondary triggers 'designing APIs' and 'improving application reliability' are broad and could overlap with API-design or reliability skills, fitting 'somewhat specific but could still overlap'; not a 3 because the broad triggers create real conflict risk.

2 / 3

Total

9

/

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
wshobson/agents
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.