CtrlK
BlogDocsLog inGet started
Tessl Logo

debug-systematically

Use this skill when diagnosing a bug, unexpected behavior, test failure, or any situation where code does not behave as expected. Follow a structured debugging process instead of randomly changing code.

71

Quality

87%

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

85%Weight 40%Scale 1-3

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A concise, well-organized debugging process with a clear sequence and validation checkpoint. The main gap is actionability: it gives specific directives but no concrete worked example or executable snippet to anchor the guidance.

Suggestions

Add a minimal concrete example for one step, such as a one-line repro command or a git bisect snippet, to make the guidance copy-paste ready.

Show a brief hypothesis/test pairing (e.g., 'Hypothesis: off-by-one in loop bounds → test with input len=0') to demonstrate the falsifiable-hypothesis step concretely.

DimensionReasoningScore

Conciseness

The ~16-line body is lean, assumes Claude's competence, and never pads with definitions of debugging concepts Claude already knows; every line earns its place.

3 / 3

Actionability

Steps are concrete imperatives and name specific tools, but there is no worked example or executable command beyond generically listing tools, so it stops short of copy-paste-ready guidance.

2 / 3

Workflow Clarity

A clearly numbered six-step sequence with an explicit 'Verify' checkpoint and an inherent hypothesis/test feedback loop; the final step re-runs failing and related tests.

3 / 3

Progressive Disclosure

A short single-purpose skill organized into three clean sections (Process, Useful tools, Anti-patterns) with no need for external references, meeting the simple-skill allowance for the top score.

3 / 3

Total

11

/

12

Passed

Description

90%Weight 40%Scale 1-3

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong, well-structured description with explicit trigger guidance and natural user-facing terms. Its only weakness is specificity: it states the overall action and triggering situations but does not list several distinct concrete capabilities.

Suggestions

Add one or two more concrete actions (e.g., 'narrow the failure to a single function, capture the minimal failing input') alongside 'Follow a structured debugging process' to lift specificity to the top anchor.

Consider mentioning common entry points users name ('stack trace', 'flaky test', 'regression') to broaden trigger-term coverage further.

DimensionReasoningScore

Specificity

The description names the debugging domain and several concrete triggering situations ('bug, unexpected behavior, test failure') plus the action 'Follow a structured debugging process', but it does not enumerate multiple distinct concrete actions like the top anchor.

2 / 3

Completeness

It opens with an explicit 'Use this skill when...' clause answering when, and states what ('Follow a structured debugging process'), so both what and when are explicitly covered.

3 / 3

Trigger Term Quality

It includes natural terms users actually say — 'bug', 'unexpected behavior', 'test failure', 'code does not behave as expected' — giving good coverage of common phrasings rather than a single keyword.

3 / 3

Distinctiveness Conflict Risk

Debugging is a clear niche with distinct triggers tied to misbehaving code, making it unlikely to fire for unrelated skills.

3 / 3

Total

11

/

12

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository
aiming-lab/MetaClaw
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.