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

73%

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 ./skills/error-recoverer/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

71%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 well-structured overview body: executable Quick Start, a clear five-phase recovery workflow with verification and escalation, and a sensible split into references and scripts. Its two real defects are a dangling reference (RECOVERY-STRATEGIES.md is listed but absent from the bundle) and a token-costly ASCII diagram that could be a compact list.

Suggestions

Fix the dangling reference: 'references/RECOVERY-STRATEGIES.md' is listed in the References section but does not exist in references/ — either add the file or remove the entry, since broken navigation is the biggest progressive-disclosure defect.

Replace the 31-line ASCII box diagram with a compact numbered list (1. Detect → 2. Classify → 3. Strategize → 4. Recover → 5. Escalate), preserving the same workflow at a fraction of the tokens.

Make the Quick Start copy-paste ready by grounding the placeholders, e.g. showing a real error/context construction or a minimal runnable snippet, which would lift actionability toward fully executable guidance.

DimensionReasoningScore

Conciseness

The body is mostly lean: a compact Quick Start, a categories table, an enum with one-line comments, and short listing sections — no explanation of concepts Claude already knows. Not 5 because the 31-line ASCII box diagram ('┌─────...ERROR RECOVERY FLOW') renders a 5-step list at high token cost, and the opening line 'Detects, classifies, and recovers from errors during autonomous coding sessions' duplicates the frontmatter description. Not 3 because beyond these minor trims every section earns its place.

4 / 5

Actionability

The Quick Start gives executable API usage ('from scripts.error_recoverer import ErrorRecoverer', 'result = await recoverer.handle_error(error, context)', '@recoverer.with_recovery') and the RecoveryStrategy enum names concrete strategy identifiers that match the listed scripts. Not 5 because the examples use undefined placeholders (project_dir, error, context) with no worked example or CLI invocation; not 3 because the guidance is real, runnable-shaped code rather than pseudocode or high-level hints.

4 / 5

Workflow Clarity

The workflow diagram sequences five clear phases (DETECT → CLASSIFY → STRATEGIZE → RECOVER → ESCALATE) and includes verification ('Verify recovery success') plus an escalation branch with 'Rollback to checkpoint' — a genuine feedback/checkpoint structure. Not 5 because the sub-steps are high-level directives (e.g. 'Query causal memory for similar errors', 'Select recovery strategy') with no concrete command or code showing how to execute or validate each phase; not 3 because sequence and key checkpoints are present, not absent.

4 / 5

Progressive Disclosure

Scored against the actual bundle: the References section lists 'references/ERROR-CATEGORIES.md' (exists) and 'references/RECOVERY-STRATEGIES.md' — which does not exist in references/ (only ERROR-CATEGORIES.md is present), so half the referenced paths are broken. The four listed scripts (error_recoverer.py, error_classifier.py, retry_handler.py, recovery_strategies.py) all exist and the body itself is an appropriate-length overview with one-level-deep pointers. The dangling reference keeps this at 3 ('could be better organized') rather than 4 ('references mostly clear; minor organization gaps'), since a missing file breaks navigation outright.

3 / 5

Total

15

/

20

Passed

Description

66%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 solid description with an explicit, well-phrased 'Use when...' trigger clause in correct third-person voice. Its weaknesses are a vague, buzzword-tinged what-clause ('Intelligent error detection and recovery') and overly broad error-handling triggers that create overlap risk with adjacent coding skills.

Suggestions

Replace the vague 'Intelligent error detection and recovery' what-clause with concrete capabilities, e.g. 'Detects, classifies, and recovers from errors in autonomous coding sessions via retry with backoff, rollback to checkpoints, and escalation' — this would raise specificity and completeness.

Sharpen distinctiveness by tying triggers to the skill's niche, e.g. 'Use when a coding agent hits a failing test, crashed operation, or repeated error and needs retry, rollback, or recovery rather than one-off debugging' — this separates it from generic debugging/testing skills.

Drop the buzzword 'Intelligent', which adds no information and is explicitly penalized as over-claiming.

DimensionReasoningScore

Specificity

The what-clause 'Intelligent error detection and recovery for autonomous coding' names the domain and two actions (detection, recovery), and the when-clause adds 'implementing retry logic' — but the actions remain abstract; concrete capabilities visible in the body (classification, rollback, escalation) are absent, and 'Intelligent' is pure buzzword. This matches anchor 3 ('names domain and 1-2 concrete actions, but not comprehensive'), not 4, because it does not list several specific actions with only minor gaps.

3 / 5

Completeness

Both parts are present: what — 'Intelligent error detection and recovery for autonomous coding'; when — an explicit 'Use when handling errors, implementing retry logic...' clause with concrete triggers. Not 5 because the 'what' is generic ('detection and recovery' omits classification, rollback, escalation); not 3 because the 'when' is explicit rather than weakly implied. Voice is correctly third person, so no specificity penalty applies.

4 / 5

Trigger Term Quality

'handling errors', 'implementing retry logic', 'recovering from failures', 'managing exception handling' are natural phrases users would say, with synonym coverage (errors/failures, retry/exception handling). Not 5: common variations like 'debugging', 'crash', or 'traceback' are missing; not 3 because coverage goes well beyond 'some relevant keywords'.

4 / 5

Distinctiveness Conflict Risk

The scope 'for autonomous coding' narrows it, but the triggers 'handling errors' and 'managing exception handling' are ubiquitous in coding contexts and would fire broadly, overlapping with debugging, testing, and general coding skills. Fits anchor 3 ('somewhat specific but could still overlap with similar skills') better than 4, which requires only minor overlap risk.

3 / 5

Total

14

/

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

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.