CtrlK
BlogDocsLog inGet started
Tessl Logo

systematic-debugging

4-phase systematic debugging methodology with root cause analysis and evidence-based verification. Use when debugging complex issues.

72

Quality

63%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./.agent/skills/systematic-debugging/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

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'

DimensionReasoningScore

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.

DimensionReasoningScore

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.

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

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

Warning

Total

10

/

11

Passed

Repository
lchenrique/politron-ide
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.