CtrlK
BlogDocsLog inGet started
Tessl Logo

error-handling

Guides Claude in reviewing and writing robust error-handling code. Covers distinguishing recoverable from unrecoverable errors, implementing retry-with-backoff patterns, structured error logging with correlation IDs, and crafting helpful user-facing error messages. Use when the user asks about error handling, exception management, try-catch patterns, error logging, retry logic, or debugging runtime failures in any codebase.

74

Quality

93%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

86%Weight 40%Scale 1-5

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

A tight, well-structured body: an ordered decision tree, opinionated good/bad examples, and a concrete retry pattern with no wasted tokens. The main gap is that the withRetry example relies on undefined isTransient/sleep helpers without guidance on classifying errors as transient.

Suggestions

Define or give a concrete example of isTransient(err) (e.g., checking error codes/status for 429, timeouts, ECONNRESET) so the retry pattern is fully copy-paste ready.

Note that sleep and isTransient are helpers to provide, or inline a minimal sleep implementation, to close the executability gap in withRetry.

DimensionReasoningScore

Conciseness

The body is lean and efficient: every section delivers guidance Claude doesn't already have (a decision tree, opinionated bad/good code pairs, a retry implementation, a structured user-facing error format) with no padding or explanation of basic concepts. It matches the 'every token earns its place' anchor; the only near-redundancy (the re-throw rule appearing in both the decision tree and the swallow-errors section) is reinforcement of a core rule, not bloat.

5 / 5

Actionability

Mostly executable guidance: complete good/bad JavaScript pairs for logging and swallowing, a concrete JSON user-facing error format, and a working withRetry implementation. It falls short of the copy-paste-ready level-5 anchor because withRetry depends on undefined helpers (isTransient, sleep) and no guidance is given for implementing isTransient per error type — a minor but real gap.

4 / 5

Workflow Clarity

The ordered 5-question decision tree ("When you encounter an error, ask in order") provides a clear, explicit sequence with per-branch directives (retry with backoff / return message / fail fast / validate and reject / log and re-throw), which serves as an effective checkpoint structure. It is not level 5 because the guidance after pattern selection is example-only, with no verification or feedback loop confirming the chosen handling is correct.

4 / 5

Progressive Disclosure

No bundle files exist and none are needed at this size; the body is well-organized into tight, headed sections with all content appropriately inline for a single-purpose skill. Under the simple-skill guidance (no external references needed, well-organized sections), this earns the top score rather than the level-4 anchor's 'minor organization gaps'.

5 / 5

Total

18

/

20

Passed

Description

96%Weight 40%Scale 1-5

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

A strong description: third-person voice, concrete capability list, and an explicit 'Use when' clause with natural trigger terms and synonyms. The only weakness is minor overlap risk with code-review/debugging skills introduced by 'reviewing' and 'debugging runtime failures' phrasing.

Suggestions

Consider scoping the 'when' clause more tightly to error/exception situations (e.g., dropping or qualifying 'debugging runtime failures') to reduce overlap with dedicated debugging and code-review skills.

If the skill is primarily for writing (not reviewing) error-handling code, lead with that distinction to sharpen differentiation from general review skills.

DimensionReasoningScore

Specificity

The description lists four concrete, specific actions — "distinguishing recoverable from unrecoverable errors, implementing retry-with-backoff patterns, structured error logging with correlation IDs, and crafting helpful user-facing error messages" — which is comprehensive coverage of the skill's capabilities. It clearly exceeds the level-4 anchor ("several specific actions; minor gaps") because no meaningful capability gap remains.

5 / 5

Completeness

Both questions are answered explicitly: the "what" ("Guides Claude in reviewing and writing robust error-handling code. Covers...") with a concrete capability list, and the "when" ("Use when the user asks about...") with concrete trigger phrases. This matches the level-5 anchor exactly; it is not level 4 because the 'when' clause is fully explicit, not merely present.

5 / 5

Trigger Term Quality

"Use when the user asks about error handling, exception management, try-catch patterns, error logging, retry logic, or debugging runtime failures" covers the natural phrasings users would say, including synonyms (error handling / exception management, retry logic / backoff). It matches the comprehensive-coverage anchor; there are no significant missing natural terms for this domain (no file extensions apply).

5 / 5

Distinctiveness Conflict Risk

The error-handling niche is clearly staked out with distinct triggers, but "reviewing... error-handling code" and "debugging runtime failures" create minor overlap risk with general code-review and debugging skills. It is mostly distinct (level 4) rather than minimal-conflict (level 5), but far more specific than the level-3 'somewhat specific' anchor.

4 / 5

Total

19

/

20

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.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
fernandezbaptiste/skill-review-sandbox
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.