CtrlK
BlogDocsLog inGet started
Tessl Logo

systematic-debugging

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

52

Quality

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

Quality

Content

77%

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 strong, well-sequenced debugging process with concrete executable instrumentation and clear validation feedback loops. Its main weaknesses are broken bundle-file references and some redundant restating of the same anti-patterns across three sections.

Suggestions

Create the referenced files (root-cause-tracing.md, defense-in-depth.md, condition-based-waiting.md) or remove/inline the references, since they currently point to non-existent files that block Claude from following the 'Trace Data Flow' step.

Consolidate the overlapping Red Flags, Common Rationalizations, and 'your human partner's Signals' sections into a single 'Stop and return to Phase 1 when...' section to remove redundancy and tighten the body.

DimensionReasoningScore

Conciseness

The body avoids explaining concepts Claude already knows and stays directive, but the Red Flags, Common Rationalizations, and 'your human partner's Signals' sections heavily restate the same anti-patterns (guessing before investigating), so it is mostly efficient yet could be tightened — fitting score 2 rather than the fully-lean score 3.

2 / 3

Actionability

It gives concrete, executable guidance — a copy-paste-ready multi-layer bash instrumentation block (echo/env/security/codesign) plus specific numbered steps and exact red-flag phrases — which for an instruction skill meets the score-3 'concrete, specific guidance' bar; it is not score 2 because the guidance is complete rather than pseudocode or missing key details.

3 / 3

Workflow Clarity

Four phases are explicitly sequenced with a 'MUST complete each phase before proceeding' gate, Phase 3 has a verify/loop checkpoint, and Phase 4 has an explicit feedback loop (≥3 failed fixes → question architecture), matching the score-3 anchor of clear sequence with explicit validation and error-recovery loops.

3 / 3

Progressive Disclosure

References to root-cause-tracing.md, defense-in-depth.md, and condition-based-waiting.md are signaled one level deep, but none of those files exist in the bundle, so the references are broken; combined with a long inline body whose Red Flags/Rationalizations/Signals content could be split out, this fits score 2 rather than the score-3 well-organized-overview anchor.

2 / 3

Total

10

/

12

Passed

Description

37%

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 is trigger-rich and uses natural language but is fundamentally incomplete because it never states what the skill does, only when to invoke it. This caps both specificity and completeness at the lowest anchor despite strong trigger-term quality.

Suggestions

Lead with a concrete capability statement before the trigger, e.g. 'Systematically investigate root causes of bugs before fixing. Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes.'

Name the concrete actions the skill performs (e.g. 'traces root causes, forms and tests single hypotheses, verifies fixes') so the 'what' is explicit and specificity moves off the lowest anchor.

Narrow the trigger or add a distinguishing qualifier so it is less likely to fire for generic troubleshooting skills that overlap the broad 'any bug, test failure, or unexpected behavior' domain.

DimensionReasoningScore

Specificity

The description is entirely a trigger clause ('Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes') and names no concrete actions the skill performs, matching the 'vague or no actions' anchor rather than the score-2 anchor that requires naming some actions.

1 / 3

Completeness

It answers 'when' explicitly but never states 'what' the skill does (e.g. systematically investigate root causes), so one of the two required answers is missing, which the score-1 anchor covers ('missing what OR when'); it is not score 2 because that anchor specifically requires 'what' to be present with 'when' missing.

1 / 3

Trigger Term Quality

It uses natural terms a user would actually say — 'bug', 'test failure', 'unexpected behavior', 'fixes' — giving good coverage of natural trigger phrasing, fitting the score-3 anchor; it is not jargon-heavy (score 1) nor missing common variations to the point of score 2.

3 / 3

Distinctiveness Conflict Risk

'before proposing fixes' carves a recognizable debugging-discipline niche, but the trigger domain 'any bug, test failure, or unexpected behavior' is broad and could overlap with other troubleshooting skills, matching the score-2 'somewhat specific but could still overlap' anchor rather than the score-3 clear-niche anchor.

2 / 3

Total

7

/

12

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
obra/superpowers
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.