4-phase systematic debugging methodology with root cause analysis and evidence-based verification. Use when debugging complex issues.
72
63%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./.agent/skills/systematic-debugging/SKILL.mdQuality
Discovery
50%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 establishes a methodological approach to debugging but remains too abstract. It mentions a '4-phase' process without explaining what those phases are, and the trigger condition 'complex issues' is subjective and vague. The description would benefit from concrete examples of actions and more specific trigger terms.
Suggestions
Expand trigger terms to include natural user language like 'bug', 'error', 'not working', 'troubleshoot', 'fix', 'crash', or 'unexpected behavior'
Specify what the 4 phases are (e.g., 'reproduce, isolate, diagnose, verify') to make capabilities concrete
Clarify what constitutes 'complex issues' in the 'Use when...' clause, such as 'multi-component failures', 'intermittent bugs', or 'issues requiring systematic investigation'
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names the domain (debugging) and mentions '4-phase systematic methodology' and 'root cause analysis', but doesn't list the specific concrete actions or what those 4 phases actually are. | 2 / 3 |
Completeness | Has a 'Use when...' clause which is good, but the trigger is vague ('complex issues') and doesn't provide explicit guidance on what distinguishes 'complex' from simple debugging scenarios. | 2 / 3 |
Trigger Term Quality | Includes 'debugging' and 'complex issues' which are relevant, but misses common variations users might say like 'bug', 'error', 'fix', 'troubleshoot', 'not working', or 'broken'. | 2 / 3 |
Distinctiveness Conflict Risk | The '4-phase systematic methodology' adds some distinctiveness, but 'debugging complex issues' is broad enough to potentially conflict with other debugging or troubleshooting skills. | 2 / 3 |
Total | 8 / 12 Passed |
Implementation
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-structured debugging methodology skill that efficiently communicates a 4-phase process with clear validation checkpoints. Its strength is workflow clarity and conciseness - it assumes Claude's intelligence and provides frameworks rather than explanations. The main weakness is that the actionability leans toward templates/checklists rather than executable code, though this is appropriate for a methodology-focused skill.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is lean and efficient, using markdown templates and checklists without explaining what debugging is or how Claude should think about problems. Every section adds actionable value. | 3 / 3 |
Actionability | Provides structured templates and checklists which are useful, but the content is more framework/methodology than executable code. The bash commands are concrete, but the core debugging phases are fill-in-the-blank templates rather than copy-paste-ready solutions. | 2 / 3 |
Workflow Clarity | Clear 4-phase sequence with explicit validation checkpoints (Phase 4 has verification checklist). The 'Before Starting', 'During Investigation', and 'After Fix' checklists provide excellent feedback loops for error recovery. | 3 / 3 |
Progressive Disclosure | Content is well-organized with clear sections, but everything is inline in a single file. For a methodology skill of this length (~80 lines of content), this is acceptable, but the anti-patterns section could potentially be separated or the skill could reference external examples. | 2 / 3 |
Total | 10 / 12 Passed |
Validation
90%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
allowed_tools_field | 'allowed-tools' contains unusual tool name(s) | Warning |
Total | 10 / 11 Passed | |
7114206
Table of Contents
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.