CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

debugging-wizard

Parses error messages, traces execution flow through stack traces, correlates log entries to identify failure points, and applies systematic hypothesis-driven methodology to isolate and resolve bugs. Use when investigating errors, analyzing stack traces, finding root causes of unexpected behavior, troubleshooting crashes, or performing log analysis, error investigation, or root cause analysis.

71

Quality

89%

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

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.

A well-structured debugging overview with exemplary reference routing (the Load When table), a disciplined workflow with explicit verification steps, and fully executable command examples. Its main weakness is redundancy: the inline debugger command section duplicates debugging-tools.md and general knowledge, costing both token efficiency and ideal content splitting.

Suggestions

Delete the 'Common Debugging Commands' section or shrink it to a one-line pointer in the reference table: it duplicates references/debugging-tools.md nearly line-for-line (pdb, node --inspect-brk, dlv) and restates commands Claude already knows, consuming ~40% of the body's tokens.

Move the git bisect walkthrough into references/strategies.md, whose 'Load When' column already covers 'git bisect', keeping the body a pure overview that routes rather than duplicates.

Merge redundant constraint pairs — 'Remove all debug code before committing' and 'Leave console.log/debugger statements in code' state the same rule twice; keep a single list.

DimensionReasoningScore

Conciseness

Mostly efficient — the Core Workflow, Constraints, and Output Templates are lean with no padded prose — but the ~38-line 'Common Debugging Commands' section duplicates references/debugging-tools.md nearly line-for-line ('python -m pdb script.py', 'node --inspect-brk script.js', 'dlv debug') and restates commands Claude already knows. Not 4 because that trimmable section is roughly 40% of the body, beyond 'minor instances'.

3 / 5

Actionability

Copy-paste-ready, executable commands covering the common debugging cases: pdb ('b 42', 'bt'), Node ('node --inspect-brk script.js'), a complete git bisect walkthrough, and delve ('dlv debug ./cmd/server'), plus a concrete output template (Root Cause/Evidence/Fix/Prevention) and specific MUST DO/MUST NOT DO rules. Not 4 because there are no gaps — every command runs as written.

5 / 5

Workflow Clarity

Clear five-step sequence (Reproduce → Isolate → Hypothesize and test → Fix → Prevent) with explicit validation embedded: 'Form testable theories, verify/disprove each one', 'Implement and verify solution', and 'Add tests/safeguards against regression'. The verify/disprove hypothesis loop plus the MUST DO/MUST NOT DO checklist matches the anchor's feedback-loops-and-checklist pattern; not 4 because the checkpoints are explicit, not implicit.

5 / 5

Progressive Disclosure

The reference table with per-topic 'Load When' conditions is exemplary — all five referenced files exist and are one level deep — but the inline 'Common Debugging Commands' section duplicates content that already lives in references/debugging-tools.md, and the git bisect walkthrough overlaps references/strategies.md's 'Binary search, git bisect, time travel' scope. Not 5 because the content is not cleanly split; not 3 because structure and signaling are otherwise strong.

4 / 5

Total

17

/

20

Passed

Description

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

An excellent description: four concrete capabilities plus an explicit 'Use when' clause with concrete trigger phrases, squarely anchored in the debugging niche with minimal conflict risk. The only gap is a few missing natural synonyms ('traceback', 'exception', 'bug', 'debug') in the trigger terms.

DimensionReasoningScore

Specificity

Lists four concrete, domain-specific actions — 'Parses error messages', 'traces execution flow through stack traces', 'correlates log entries to identify failure points', and 'applies systematic hypothesis-driven methodology to isolate and resolve bugs' — comprehensively covering the workflow from input analysis to resolution. Not 4: there are no coverage gaps; the actions span the full debugging process.

5 / 5

Completeness

Explicitly answers both what ('Parses error messages... to isolate and resolve bugs') and when ('Use when investigating errors, analyzing stack traces... or root cause analysis'). It mirrors the anchor-5 example structure exactly; not 4 because the 'when' clause is explicit and concrete rather than merely present.

5 / 5

Trigger Term Quality

'Use when investigating errors, analyzing stack traces, finding root causes of unexpected behavior, troubleshooting crashes, or performing log analysis, error investigation, or root cause analysis' provides good natural-term coverage. Not 5: several common phrases a user would naturally say — 'traceback', 'exception', 'bug', 'debug' — are absent from the description.

4 / 5

Distinctiveness Conflict Risk

A clear debugging niche with distinct triggers — 'analyzing stack traces', 'troubleshooting crashes', 'root cause analysis' — unlikely to fire for unrelated skills. 'log analysis' is framed as failure investigation ('correlates log entries to identify failure points'), keeping conflict risk minimal; not 4 because no meaningful overlap with adjacent skills remains.

5 / 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

Jeffallan/claude-skills

Path

skills/debugging-wizard/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.