CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

diagnosing-bugs

Diagnosis loop for hard bugs and perf regressions. Trigger: diagnose, debug this, something broken/failing/slow.

Quality

91%

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

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

This is a strong process skill: lean and imperative with zero filler, concrete and runnable guidance at every phase, explicit validation gates between phases, and a correctly factored bundle (one referenced script that exists and is used as described). The discipline framing (tight red-capable loop as the core deliverable) is consistently enforced with checklists and completion criteria.

DimensionReasoningScore

Conciseness

The body is dense, imperative, and assumes Claude's competence throughout — e.g. "Spend disproportionate effort here", "Cut inputs, callers, config, data, and steps one at a time", "Untagged logs survive; tagged logs die". No section explains concepts Claude already knows; rationale lines ("Wrong bug = wrong fix", "Why bother: a minimal repro shrinks the hypothesis space") are minimal and load-bearing, matching anchor 5 rather than anchor 4's 'minor instances that could be trimmed'.

5 / 5

Actionability

Guidance is concrete and executable at every step: a ranked list of 10 loop-construction tactics (failing test, curl script, "run 1000 random inputs", "`git bisect run` it"), a real script path (`scripts/hitl-loop.template.sh`, which exists in the bundle), a concrete log-tag convention (`[DEBUG-a4f2]` with "Cleanup at the end becomes a single grep"), and a falsifiable-hypothesis format string. For an instruction-only skill this is fully specific guidance with copy-paste-ready artifacts, matching anchor 5.

5 / 5

Workflow Clarity

Six phases are clearly sequenced with explicit validation gates and checklists: "No red-capable command, no Phase 2", "Do not proceed until you have reproduced and minimised", a 4-item red-capable checklist, "Watch it fail / Apply the fix / Watch it pass / Re-run the Phase 1 loop", and a Phase 6 cleanup checklist. This is the anchor-5 pattern (explicit validation steps, feedback loops, checklists) with no gaps that would place it at 4.

5 / 5

Progressive Disclosure

The body is a well-sectioned overview whose only bundle dependency — `scripts/hitl-loop.template.sh` — is clearly signaled, one level deep, and verified to exist with content matching its description (step/capture helpers, KEY=VALUE output). All inline content (phases, checklists, construction tactics) is the core instruction and appropriately belongs in SKILL.md; navigation via phase headers is easy, matching anchor 5.

5 / 5

Total

20

/

20

Passed

Description

78%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 compact, third-person, and answers both what and when with explicit trigger phrases. Its main gap is specificity — it names the process but not the concrete activities inside it — and trigger coverage misses a few common synonyms like "not working" or "flaky".

Suggestions

Name 1-2 concrete actions inside the loop in the 'what' half, e.g. "Runs a reproduce/minimise/hypothesise/instrument/fix loop with a regression test" to lift specificity.

Add a few high-frequency synonyms to the trigger list, e.g. "not working", "flaky", "why is X happening", or "regression".

Optionally narrow the broad "something broken/failing/slow" trigger to hard-to-reproduce or stubborn bugs to reduce overlap with simpler debugging or testing skills.

DimensionReasoningScore

Specificity

"Diagnosis loop for hard bugs and perf regressions" names the domain and a single core action (a structured diagnosis loop), but does not enumerate what the loop actually involves (build a repro loop, minimise, hypothesise, instrument, fix with a regression test). This matches anchor 3 ('names domain and 1-2 concrete actions, but not comprehensive'); it is above anchor 2 because the domain is concrete, and below anchor 4 because only one action is stated.

3 / 5

Completeness

Both 'what' ("Diagnosis loop for hard bugs and perf regressions") and 'when' (explicit "Trigger: diagnose, debug this, something broken/failing/slow") are clearly and explicitly answered with concrete trigger phrases, matching the anchor-5 example pattern. Anchor 4 does not fit because the 'when' clause is already explicit and phrase-level specific, not merely implied.

5 / 5

Trigger Term Quality

"Trigger: diagnose, debug this, something broken/failing/slow" gives several natural phrases a user would actually say. Below anchor 5 because common variants like "not working", "why does X happen", "flaky", "crash", or "regression" are absent; above anchor 3 because the listed terms are natural user language, not jargon.

4 / 5

Distinctiveness Conflict Risk

The niche (a diagnosis discipline for hard bugs and perf regressions) is mostly distinct, with triggers that would not fire for unrelated skills. Below anchor 5 because broad trigger phrases like "something broken/failing/slow" could overlap with testing or code-review skills; above anchor 3 because the framing around hard bugs and perf regressions carves a clear niche.

4 / 5

Total

16

/

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

YoizenSA/dev-ai-workflow

Path

ywai/skills/diagnosing-bugs/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.