CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

phase-gated-debugging

Use when debugging any bug. Enforces a 5-phase protocol where code edits are blocked until root cause is confirmed. Prevents premature fix attempts.

Quality

82%

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

92%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.

The body is an exemplary instruction-only skill: a tightly sequenced 5-phase protocol with explicit gates (user confirmation before fixes), feedback loops (failed verification returns to Phase 2), concrete bug-type techniques, and near-zero padding. The only improvement opportunity is trimming the motivational Overview line and the partially redundant Key Rules summary.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence — no basic-concept explanation (e.g., it names 'git bisect' or '5 Whys' without tutorials), and each phase is 1-3 lines. Minor trims exist: the Overview's motivation ('They guess at fixes, get it wrong, and spiral') and the Key Rules section partially restate rules already specified per-phase, which is the only noticeable padding. This fits anchor 4 (efficient; minor instances that could be trimmed) rather than 5, where every token would earn its place.

4 / 5

Actionability

For an instruction-only skill the guidance is fully actionable: exact phase actions ('Run the failing command/test. Capture the exact error. Run 2-3 times'), a concrete diagnostic convention ('logging marked // DEBUG'), a copy-paste-ready confirmation script ('This is my root cause analysis: [explanation]. Do you agree, or should I investigate further?'), specific counts ('run 5+ times' for intermittent bugs), and a bug-type table mapping each failure class to a named technique. Specific examples cover the common cases, matching anchor 5.

5 / 5

Workflow Clarity

The 5-phase protocol is a clear sequence with explicit validation checkpoints — 'Run 2-3 times for consistency' in Phase 1, '**WAIT for user confirmation. Do NOT proceed without it.**' gating Phase 3 — and an explicit error-recovery feedback loop ('If verification fails: root cause was wrong, go back to Phase 2'). This matches anchor 5 (clear sequence, explicit validation, feedback loops) and the guidelines' emphasis on checkpointed workflows.

5 / 5

Progressive Disclosure

The skill is a single compact file (~60 lines) with well-organized sections (Overview, When to Use, Protocol, Bug-Type Strategies, Key Rules) and no bundle files exist, so nothing is inlined that belongs in a separate reference — the bug-type table is the only candidate and is appropriately brief. Per the scoring note for simple skills without external references, well-organized sections alone earn anchor 5.

5 / 5

Total

19

/

20

Passed

Description

66%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.

A well-formed description with a clear 'what', an explicit 'Use when' clause, and an identifiable niche (disciplined, phase-gated debugging). Its weaknesses are breadth — 'any bug' triggers on nearly every debugging task, raising conflict risk — and a single generic trigger phrase that leaves natural synonyms like 'error', 'crash', 'regression', or 'failing test' uncovered.

Suggestions

Replace 'Use when debugging any bug' with concrete trigger phrases that mirror the body's When-to-Use list, e.g. 'Use when a bug keeps getting "fixed" without resolving, when an agent repeatedly guesses at fixes, or for intermittent, regression, or performance failures' — this raises completeness and trigger-term coverage simultaneously.

Add natural synonyms such as 'error', 'crash', 'failing test', or 'broken' to the trigger terms so the description matches the varied phrasings users actually say.

Briefly name one or two of the protocol's concrete behaviors (e.g., 'reproduce before investigating, confirm root cause with the user before editing') to lift specificity above generic 'enforces a protocol' language and sharpen distinctiveness against general debugging skills.

DimensionReasoningScore

Specificity

The description names the domain ('debugging') and two concrete mechanisms ('Enforces a 5-phase protocol where code edits are blocked until root cause is confirmed', 'Prevents premature fix attempts'), but does not enumerate what the phases are or what the protocol actually involves, so coverage is not comprehensive. It sits between anchor 3 (names domain and 1-2 concrete actions) and anchor 4 (several specific actions), closer to 3 because the two named behaviors overlap heavily and 'prevents premature fix attempts' restates the edit-blocking rather than adding a distinct action.

3 / 5

Completeness

Both parts are present: the 'what' is clear ('Enforces a 5-phase protocol where code edits are blocked until root cause is confirmed') and the 'when' is explicit ('Use when debugging any bug'), satisfying the guideline that a 'Use when...' clause be present. It falls short of anchor 5 because 'any bug' is a single generic trigger rather than concrete trigger phrases (compare the 5-anchor's 'when the user mentions PDFs, forms, or document extraction'), and the body's sharper triggers (e.g., a bug repeatedly 'fixed' without resolving) are absent.

4 / 5

Trigger Term Quality

It includes the natural core terms a user would say — 'debugging', 'bug', 'root cause', 'fix', 'code edits' — giving good keyword coverage, but misses common variations such as 'error', 'crash', 'failing test', 'regression', or 'broken'. This matches anchor 4 (good keyword coverage; a few natural terms missing) rather than 5, which requires synonyms and comprehensive variation coverage.

4 / 5

Distinctiveness Conflict Risk

'Use when debugging any bug' claims the entire debugging domain, so it would trigger on virtually any debugging request and overlap with any other debugging or troubleshooting skill. The 5-phase edit-blocking mechanism does give it a distinguishable identity within that domain, matching anchor 3 (somewhat specific but could still overlap with similar skills) rather than 2, since conflicts are limited to one skill category rather than 'many similar skills'.

3 / 5

Total

14

/

20

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.

Validation — 15 / 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

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

skills/phase-gated-debugging/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.