CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

systematic-debugging

Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes

Quality

65%

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

Quality

Content

70%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 content is a well-sequenced debugging workflow with strong validation checkpoints, feedback loops, and mostly concrete instrumentation examples. Its main weaknesses are broken bundle references (three cited files are missing) and redundant restatements of the same anti-guessing message that inflate token cost.

Suggestions

Add the referenced files `root-cause-tracing.md`, `defense-in-depth.md`, and `condition-based-waiting.md` to the bundle (or remove the references) — currently the skill points to files that do not exist.

Consolidate the redundant anti-guessing sections (The Iron Law, Red Flags, Common Rationalizations, your human partner's Signals) into one section; the message is repeated four times.

Drop the unverifiable "Real-World Impact" statistics and fix the "Phase 4.5" cross-reference (the architecture questioning is step 5 of Phase 4, not a separate phase).

DimensionReasoningScore

Conciseness

Mostly efficient process instruction, but the core 'no fixes without root cause' message is repeated across "The Iron Law", "Red Flags", "Common Rationalizations", and "your human partner's Signals" sections, and the "Real-World Impact" section pads with unverifiable statistics ("First-time fix rate: 95% vs 40%"). Not anchor 2's 'several unnecessary explanations of known concepts', but clearly could be tightened and trimmed.

3 / 5

Actionability

Concrete, mostly executable guidance throughout: specific commands ("Git diff, recent commits", "env | grep IDENTITY", "security list-keychains", "codesign --sign ... --verbose=4") and crisp decision rules ("If < 3: Return to Phase 1... If ≥ 3: STOP and question the architecture"). Minor gaps: the multi-layer instrumentation block is a checklist rather than runnable code, and "${IDENTITY:+SET}${IDENTITY:-UNSET}" prints the value when set, not a clean SET/UNSET indicator. Falls just short of anchor 5's copy-paste-ready coverage.

4 / 5

Workflow Clarity

The four phases are strictly sequenced ("You MUST complete each phase before proceeding to the next") with explicit validation gates ("Did it work? Yes → Phase 4 / Didn't work? Form NEW hypothesis"), error-recovery feedback loops (fix fails → count attempts → return to Phase 1 or question architecture), and a Quick Reference checklist table. This matches anchor 5's 'explicit validation steps; feedback loops for error recovery; checklists' despite the trivial mislabel of the architecture step as "Phase 4.5".

5 / 5

Progressive Disclosure

Section structure is good and references are clearly signaled one level deep ("See `root-cause-tracing.md` in this directory", plus a Supporting Techniques index), but the three referenced bundle files (`root-cause-tracing.md`, `defense-in-depth.md`, `condition-based-waiting.md`) do not exist in the bundle — navigation leads to missing files. This is worse than anchor 4's 'minor organization gaps' and lands at anchor 3: structure present, references present, but discovery is broken.

3 / 5

Total

15

/

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 a strong, explicit trigger clause with good timing guidance, but it is a pure trigger: it never tells the reader what the skill does. Adding a 'what' clause describing the systematic root-cause process would substantially raise both completeness and specificity.

Suggestions

Add a 'what' clause stating the concrete process, e.g.: "Systematically debug via a four-phase root-cause process: reproduce the issue, gather evidence, form and test a single hypothesis, then implement the fix with a failing test first. Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes."

Include common trigger synonyms such as "errors", "failing tests", "crashes", or "broken behavior" so the description matches the varied phrasings users actually say.

Briefly differentiate from adjacent skills (e.g., test-driven development, fix verification) by emphasizing the 'diagnose before fixing' scope.

DimensionReasoningScore

Specificity

The description names the domain ("any bug, test failure, or unexpected behavior") but contains no concrete actions whatsoever — it never states what the skill actually does. It sits between anchor 1 (entirely vague) and anchor 3 (1-2 concrete actions): more domain-identifying than "Helps with documents", but with zero actions rather than minimal ones.

2 / 5

Completeness

The 'when' is explicit and well-qualified ("Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes") but the 'what' is entirely absent — the description never mentions systematic debugging, root cause investigation, or the four-phase process. This exactly matches anchor 2 ("only 'when' is present without 'what'"), parallel to the example "Use when working with documents".

2 / 5

Trigger Term Quality

"bug", "test failure", and "unexpected behavior" are natural phrases users say when debugging, giving good keyword coverage. Common variations like "error", "crash", "failing", "broken", or "not working" are missing, which keeps it just below anchor 5.

4 / 5

Distinctiveness Conflict Risk

The debugging niche is somewhat specific and the "before proposing fixes" timing qualifier helps distinguish it from fix-execution skills, but "ANY bug... or unexpected behavior" makes it trigger on nearly every error scenario, so overlap with related error-fixing, testing, and verification skills is plausible. More specific than anchor 2's "Helps with document files", less clearly niche than anchor 5.

3 / 5

Total

11

/

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

lucianghinda/superpowers-ruby

Path

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