CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

diagnosing-bugs

Diagnosis loop for hard bugs and performance regressions. Use when the user says "diagnose"/"debug this", or reports something broken/throwing/failing/slow.

68

Quality

86%

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

The canonical home for this skill is diagnosing-bugs in mattpocock/skills

SKILL.md
Quality
Evals
Security

Quality

Content

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

An exemplary process skill: phases are gated by explicit, checkable criteria, guidance is concrete and executable, and it assumes Claude's competence throughout. The only real critiques are minor rhetorical flourishes and the fact that the full catalogue of loop-construction techniques keeps the main file long.

DimensionReasoningScore

Conciseness

The body is dense and imperative with zero explanation of concepts Claude already knows, but carries minor rhetorical padding that could be trimmed — "a debugging superpower", "Untagged logs survive; tagged logs die", "Build the right feedback loop, and the bug is 90% fixed". That matches 'efficient; minor instances that could be trimmed' rather than every-token-earns-its-place (5).

4 / 5

Actionability

Guidance is fully executable for an instruction-only skill: a ranked list of 10 concrete loop-construction techniques, an exact debug-log tag pattern ([DEBUG-a4f2]) with a grep-based cleanup, a concrete falsifiability format ("If <X> is the cause, then <changing Y>..."), specific commands (git bisect run, performance.now(), diff against a pristine copy), and a real, runnable bundle script at scripts/hitl-loop.template.sh. This matches the top anchor for actionable instruction skills.

5 / 5

Workflow Clarity

Six phases are strictly sequenced with explicit gates and validation: a Phase 1 completion-criterion checklist ("No red-capable command, no Phase 2"), a Phase 2 repro/minimise checklist, watch-fail-then-watch-pass regression-test steps, and a Phase 6 cleanup checklist (re-run loop, grep debug tags, state the winning hypothesis). This matches the anchor with explicit validation steps, feedback loops, and checklists; the destructive/batch cap does not apply.

5 / 5

Progressive Disclosure

Good structure: clear phase headers, and the single external artifact (scripts/hitl-loop.template.sh) is a real, one-level-deep, well-signaled reference used exactly where needed. It falls short of the top anchor because at ~130 lines nearly all detail (the 10 techniques, tighten-the-loop, and non-determinism subsections) is inlined in SKILL.md rather than split into reference files.

4 / 5

Total

18

/

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.

A strong description with an explicit 'Use when' clause and genuinely natural trigger phrases. Its main weakness is that the capability statement is a single abstract action ("diagnosis loop") rather than several concrete actions, and it misses a few common trigger synonyms.

Suggestions

Enumerate 2-3 concrete actions in the 'what' clause, e.g. "Runs a reproduce-then-hypothesize diagnosis loop: builds a tight feedback loop, bisects regressions, instruments code, and locks in the fix with a regression test."

Add common trigger synonyms such as "crash", "error", "exception", "not working", or "regressed" to the 'Use when' clause so more user phrasings match.

Narrow the broadest triggers ("broken", "failing") toward the hard-bug niche (e.g. "a bug they can't pin down") to reduce overlap with routine debugging requests.

DimensionReasoningScore

Specificity

"Diagnosis loop for hard bugs and performance regressions" names the domain and exactly one action (running a structured diagnosis loop), matching the '1-2 concrete actions, not comprehensive' anchor. It does not list several specific actions (4) nor reduce to purely generic action (2).

3 / 5

Completeness

It clearly answers both: what ("Diagnosis loop for hard bugs and performance regressions") and when, with an explicit 'Use when' clause containing concrete trigger phrases ("diagnose"/"debug this", reports something broken/throwing/failing/slow). This mirrors the anchor-5 example structure; the 'when' is not merely implicit or under-specified (4).

5 / 5

Trigger Term Quality

Explicit natural triggers — "diagnose", "debug this", "broken", "throwing", "failing", "slow" — are phrases users actually say, but common variations like "crash", "error", or "not working" are missing, so coverage is good rather than comprehensive (5).

4 / 5

Distinctiveness Conflict Risk

The hard-bug/perf-regression diagnosis niche is distinct with dedicated triggers, but broad words like "broken", "failing", and "slow" create minor overlap risk with general debugging, triage, or profiling skills. It is more distinct than the somewhat-overlapping anchor (3) but not minimal-conflict (5).

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

withcoral/coral

Path

.agents/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.