CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

error-recoverer

Intelligent error detection and recovery for autonomous coding. Use when handling errors, implementing retry logic, recovering from failures, or managing exception handling.

Quality

74%

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

Fix and improve this skill with Tessl

tessl review fix ./.claude/skills/error-recoverer/SKILL.md

The canonical home for this skill is error-recoverer in fernandezbaptiste/Skrillz

SKILL.md
Quality
Evals
Security

Quality

Content

63%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.

The body is a solid overview with executable quick-start code, a clear five-step workflow including verification and escalation, and clean sectioning. Main deductions are the token-heavy ASCII diagram and redundant enum block, an undefined-variable quick start, and a cited reference file (RECOVERY-STRATEGIES.md) that is missing from the bundle.

Suggestions

Create references/RECOVERY-STRATEGIES.md or remove its entry — the pointer currently dead-ends for a core topic.

Replace the 30-line ASCII box diagram with a compact numbered list and fold the RecoveryStrategy enum into the existing categories table to cut roughly half the body's tokens.

Complete the quick-start snippets: show where project_dir and context come from, and include the ErrorRecoverer construction in the '@recoverer.with_recovery' example so both snippets are copy-paste runnable.

DimensionReasoningScore

Conciseness

The ~30-line ASCII box diagram duplicates what a compact numbered list would convey in a third of the tokens, and the RecoveryStrategy enum block repeats strategy information already shown in the Error Categories table. Mostly efficient otherwise — no explanations of concepts Claude already knows — so anchor 3 fits better than the padded anchor 2 or the minor-trim anchor 4.

3 / 5

Actionability

Quick start provides concrete executable Python ('ErrorRecoverer(project_dir)', 'result = await recoverer.handle_error(error, context)', '@recoverer.with_recovery') plus a specific category-to-strategy table. Minor gaps keep it at 4: 'project_dir' and 'context' are never defined and the decorator example omits setup; not 5 because snippets are not fully copy-paste ready; not 3 because the code is real and executable, not pseudocode.

4 / 5

Workflow Clarity

The DETECT → CLASSIFY → STRATEGIZE → RECOVER → ESCALATE sequence is clearly ordered, includes 'Verify recovery success' as a checkpoint and an explicit failure path ('Rollback to checkpoint... Signal for human intervention'), which is a feedback loop. Not 5 because verification exists only as one-line diagram entries with no detail on criteria or how verification is performed; not 3 because checkpoints are present, not absent.

4 / 5

Progressive Disclosure

The body is a well-organized overview with clearly signaled one-level references and scripts sections, but 'references/RECOVERY-STRATEGIES.md' is cited and does not exist in the bundle (only ERROR-CATEGORIES.md is present; all four listed scripts do exist), so navigation fails for a key topic. Anchor 3 fits: good structure undermined by a broken reference is more than the 'minor organization gaps' of anchor 4.

3 / 5

Total

14

/

20

Passed

Description

75%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.

The description has a strong explicit 'Use when...' clause with concrete, natural trigger phrases and answers both what and when. Its weaknesses are the buzzword 'Intelligent', a thin what-clause that omits classification/rollback/escalation, and broad triggers that risk conflicts with debugging-style skills.

Suggestions

Drop the buzzword 'Intelligent' and expand the what-clause with the skill's concrete capabilities, e.g. 'Classifies errors, retries with backoff, rolls back to checkpoints, and escalates unrecoverable failures'.

Narrow or sharpen the trigger terms so they don't overlap generic debugging (e.g. mention 'autonomous coding session failures' rather than bare 'handling errors').

Add commonly-said synonyms such as 'crashes', 'stack traces', or 'test failures' to the when-clause to improve trigger coverage.

DimensionReasoningScore

Specificity

"error detection and recovery" names the domain plus two concrete actions, but the what-clause is thin (classification, rollback, escalation absent) and "Intelligent" is buzzword padding. Not 4 because it lacks the several-specific-actions coverage of anchor 4; not 2 because two concrete actions are explicitly named, unlike 'Processes PDF files'.

3 / 5

Completeness

Explicitly answers what ("Intelligent error detection and recovery for autonomous coding") and when ("Use when handling errors, implementing retry logic, recovering from failures, or managing exception handling") with four concrete trigger phrases, matching the anchor-5 pattern. Anchor 4 does not fit because the when-clause is specific and multi-trigger, not a single broad condition.

5 / 5

Trigger Term Quality

The when-clause includes natural phrases users would say: "handling errors", "implementing retry logic", "recovering from failures", "managing exception handling". Not 5 because common synonyms like crash, stack trace, debug, or test failure are missing; not 3 because multiple natural terms are present rather than one generic keyword.

4 / 5

Distinctiveness Conflict Risk

"handling errors" and "exception handling" are broad triggers that would also fire a debugging or test-fixing skill; "for autonomous coding" narrows the domain only somewhat. Somewhat specific (retry/recovery niche) but real overlap risk with closely adjacent skills, fitting anchor 3 rather than the minor-overlap anchor 4.

3 / 5

Total

15

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

14

/

16

Passed

Repository

fernandezbaptiste/Skrillz

Path

.claude/skills/error-recoverer/SKILL.md

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.