CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

debug

Use when encountering any bug, test failure, unexpected behavior, or error - before proposing fixes. Use especially when previous fix attempts have failed.

Quality

68%

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/debug/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

Strong process skill: the 4-phase workflow is clearly sequenced with explicit BLOCKED checkpoints, feedback loops, and a three-strike escalation rule, and it includes concrete git/grep commands. Main weakness is mild redundancy (final summary template and Rules section restate earlier gates) rather than any missing structure.

DimensionReasoningScore

Conciseness

The body is directive throughout ("Read the error completely", "Reproduce the bug", "Never guess - Evidence first") and never explains concepts Claude already knows, but minor trimming is possible: the final "Output" banner template and the "Rules" section partially restate the per-phase BLOCKED gates and the Anti-Rationalization table.

4 / 5

Actionability

Concrete, copy-paste-ready commands are provided ("git log --oneline -10", "git diff HEAD~3", "grep -r \"error message\" .", "git add -A && git commit -m \"fix: [description]\"", "git tag checkpoint/bugfix-[name]") alongside numbered steps per phase; minor gaps remain, e.g. "Execute minimal test" gives no example of what such a test looks like.

4 / 5

Workflow Clarity

Four phases are explicitly sequenced with hard validation gates ("BLOCKED until evidence collected", "BLOCKED until patterns identified", "BLOCKED until hypotheses formulated"), explicit feedback loops ("If rejected: Test next hypothesis"), error recovery via the Three-Strike Rule, and verification steps ("Verify test passes", "Reproduction test: PASS").

5 / 5

Progressive Disclosure

A single self-contained file with well-organized sections (Phases, Workflow, Three-Strike Rule, Output, Anti-Rationalization, Rules) and no external references — appropriately so, since no detail here needs a separate file — though at ~210 lines a few inline per-phase output templates could be tightened to make the overview leaner.

4 / 5

Total

17

/

20

Passed

Description

43%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 excellent, explicit trigger guidance with natural phrasing, but it is one-sided: it says when to use the skill and never what the skill does (the systematic 4-phase debugging methodology is invisible from the description). Its broad triggers ('any... error', 'unexpected behavior') also create real overlap risk with adjacent skills.

Suggestions

Add a 'what' clause before the triggers, e.g. 'Systematically debugs bugs through a 4-phase methodology (gather evidence, analyze patterns, formulate hypotheses, implement and prove the fix). Use when encountering any bug...'.

Include the skill's distinguishing capability in the trigger sentence — e.g. 'before proposing fixes' could become 'to find the root cause before proposing fixes' — so it is distinguishable from generic error-handling or testing skills.

Add common synonyms such as crash, exception, traceback, or regression to broaden natural trigger coverage without adding vagueness.

DimensionReasoningScore

Specificity

The description names the domain ("any bug, test failure, unexpected behavior, or error") but contains no concrete capability actions — phrases like "before proposing fixes" only imply what the skill does, never stating it (e.g. systematic 4-phase debugging). This matches 'names the domain but actions are minimal or generic' rather than score 3, which requires 1-2 named actions.

2 / 5

Completeness

The 'when' is explicit and strong ("Use when encountering...", "Use especially when previous fix attempts have failed") but the 'what' is entirely absent — the description never says what the skill actually does. This exactly matches anchor 2 ('only when is present without what', e.g. 'Use when working with documents'); it cannot be 3-4 because those require at least a clear 'what'.

2 / 5

Trigger Term Quality

Good natural coverage with "bug", "test failure", "unexpected behavior", and "error" — phrases users genuinely say — plus the distinctive "previous fix attempts have failed". Not score 5 because common synonyms like crash, exception, traceback, or regression are missing; clearly above score 3's 'missing common variations'.

4 / 5

Distinctiveness Conflict Risk

The debugging niche is somewhat specific ("bug", "previous fix attempts have failed" is distinctive), but the sweeping triggers "any... error" and "unexpected behavior" would fire on nearly every technical conversation and overlap with testing or error-handling skills — matching 'somewhat specific but could still overlap with similar skills' rather than the minor-overlap profile of score 4.

3 / 5

Total

11

/

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

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

frontmatter_unknown_keys

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

Warning

Total

14

/

16

Passed

Repository

fernandezbaptiste/specialist-agent

Path

skills/debug/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.