CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

dev-debug

AI DevKit · Guide structured debugging before code changes by clarifying expected behavior, reproducing issues, identifying likely root causes, and agreeing on a fix plan with validation steps. Use when users ask to debug bugs, investigate regressions, triage incidents, diagnose failing behavior, handle failing tests, analyze production incidents, investigate error spikes, or run root cause analysis (RCA).

Quality

94%

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-5

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

A tight, evidence-first debugging workflow with explicit validation checkpoints, feedback loops, and an approval gate before code changes — workflow clarity and structure are excellent. Actionability and conciseness are slightly held back by a few unexplained external-skill references and minor hedging that could be trimmed.

Suggestions

Tighten the Task Tracing section: replace the availability hedge ('If task tracing is usable... Never block debugging because task tracing is unavailable') with one line stating what to record and move on.

Add minimal invocation detail or a one-line pointer for the external skills referenced (dev-smoke, verify, dev-retro) so steps like 'make the repro a dev-smoke check' are directly executable.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence ('Debug with an evidence-first workflow before changing code', tight workflow bullets), but a few spots could be trimmed — the Task Tracing hedge ('If task tracing is usable... Never block debugging because task tracing is unavailable') and the table's 'Why It's Wrong' column add tokens without much instruction value. Fits the 4 anchor (minor trims possible), not 5 (not every token earns its place) and not 3 (no padded explanations of concepts Claude already knows).

4 / 5

Actionability

Provides two exact executable commands ('npx ai-devkit@latest memory search --query ... --tags "debug,root-cause"', and the memory store command) plus a concrete hypothesis template ('Predicted evidence if true / Disconfirming evidence if false / Exact test command or check'). Minor gaps remain — e.g. 'make the repro a dev-smoke check' and 'record repro/final results as evidence' reference external skills without any invocation detail — so 4 rather than 5; well above 3 since the guidance is executable, not pseudocode.

4 / 5

Workflow Clarity

A clear four-phase sequence (Clarify → Reproduce → Hypothesize and Test → Plan) with explicit validation checkpoints ('Confirm a pre-fix failing signal exists', 'Confirm post-fix success using the verify skill — including regression verification') and built-in feedback loops (disconfirming evidence, one-variable-at-a-time tests) plus an approval gate ('Do not modify code until the user approves a selected fix plan'). Matches the 5 anchor; a 4 would lack explicit checkpoints or error-recovery loops.

5 / 5

Progressive Disclosure

No bundle files exist and the ~60-line body is appropriately organized into well-signaled sections (Hard Rule, Workflow, Validation, Task Tracing, Red Flags, Output Template) with nothing inlined that belongs in a separate file. External-skill references (dev-smoke, verify, dev-retro) are clearly named. Matches the 5 anchor for a simple, well-organized skill; not 4 as there are no organization gaps to point to.

5 / 5

Total

18

/

20

Passed

Description

100%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 is exemplary: third-person voice, concrete multi-action capability statement, and an extensive 'Use when' clause covering natural trigger phrases with synonyms. Its debugging niche is clearly delineated with minimal conflict risk.

DimensionReasoningScore

Specificity

Lists four concrete, distinct actions — 'clarifying expected behavior, reproducing issues, identifying likely root causes, and agreeing on a fix plan with validation steps' — comprehensively covering the debugging workflow. No coverage gaps that would justify a 4.

5 / 5

Completeness

Explicitly answers both what ('Guide structured debugging before code changes by clarifying... reproducing... identifying... agreeing on a fix plan with validation steps') and when ('Use when users ask to debug bugs... or run root cause analysis (RCA)') with concrete trigger phrases. Matches the 5 anchor exactly; a 4 would require a less explicit 'when'.

5 / 5

Trigger Term Quality

The 'Use when' clause covers natural phrasings with synonym variants: 'debug bugs, investigate regressions, triage incidents, diagnose failing behavior, handle failing tests, analyze production incidents, investigate error spikes, or run root cause analysis (RCA)'. Matches the comprehensive-synonyms anchor; not 4 since no common natural term is missing.

5 / 5

Distinctiveness Conflict Risk

Debugging/RCA is a clear niche with distinct, debugging-specific triggers (regressions, failing tests, incidents, error spikes, RCA); minimal overlap risk with adjacent skills like code review. Matches the 5 anchor rather than 4, which would require noticeable overlap with closely related skills.

5 / 5

Total

20

/

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

codeaholicguy/ai-devkit

Path

skills/dev-debug/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.