CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

diagnose

Disciplined diagnosis loop for hard bugs and performance regressions. Reproduce → minimise → hypothesise → instrument → fix → regression-test. Use when user says "diagnose this" / "debug this", reports a bug, says something is broken/throwing/failing, or describes a performance regression.

90

0.97x
Quality

90%

Does it follow best practices?

Impact

90%

0.97x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No findings from the security scan

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 excellent instruction-style skill body: gated phases, checklists, concrete tactics with named tools, and a verified HITL template script make it highly actionable with strong validation feedback loops. The only weaknesses are mild rhetorical padding and a roughly 117-line monolithic body that could split some detail into a reference file.

Suggestions

Move the ten loop-construction tactics (or the non-deterministic-bug guidance) into a references/ file, keeping SKILL.md as a lean overview with one-line pointers.

Trim motivational flourishes like 'Be aggressive. Be creative. Refuse to give up.' in favor of the already-concrete ordering guidance.

DimensionReasoningScore

Conciseness

The body is dense with non-obvious, opinionated guidance and explains nothing Claude already knows — every phase carries discipline rules rather than tutorials. It is not a 5 because a few rhetorical flourishes ('Be aggressive. Be creative. Refuse to give up.', 'A 2-second deterministic loop is a debugging superpower', 'Untagged logs survive; tagged logs die') are trimmable padding; and it is well above a 3 since almost every line instructs.

4 / 5

Actionability

Concrete, executable guidance throughout: 10 ranked loop-construction tactics naming specific tools (curl, Playwright, git bisect, differential runs), a falsifiable-hypothesis format template, a concrete tagging convention ('[DEBUG-a4f2]'), a perf-branch procedure (baseline then bisect), and a real, usable bundle script (scripts/hitl-loop.template.sh, verified present with step/capture helpers). This matches the top anchor for instruction-only skills — nothing is left as vague direction.

5 / 5

Workflow Clarity

Six explicitly gated phases with sequence ('Do not proceed to Phase 2 until you have a loop you believe in', 'Do not proceed until you reproduce the bug'), validation checklists in Phases 2 and 6, and a fix feedback loop (watch test fail, apply fix, watch pass, re-run the original loop). Clear sequence plus explicit validation, feedback loops, and checklists is the 5 anchor.

5 / 5

Progressive Disclosure

Well-organized phase headings and one clearly signaled, one-level-deep bundle reference (scripts/hitl-loop.template.sh, which exists). Not a 5 because at roughly 117 lines everything else is inline in SKILL.md — the ten loop-construction tactics could live in a reference file to keep SKILL.md closer to an overview; not below 4 since structure is clean and the single reference is real and well-signaled.

4 / 5

Total

18

/

20

Passed

Description

88%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: it states the full six-phase workflow concretely and pairs it with an explicit, natural-language 'Use when' clause covering multiple trigger phrasings. The only gaps are a few missing common synonyms (crash, error, not working) and slight breadth in the bug-reporting triggers.

Suggestions

Add a couple of common synonyms to the trigger clause, e.g. 'crashes', 'throws errors', or 'something is not working'.

Narrow the trigger scope slightly (e.g. 'reports a hard-to-reproduce bug or a performance regression') to reduce overlap with generic fix-it skills.

DimensionReasoningScore

Specificity

The description names the domain ('hard bugs and performance regressions') and enumerates the full pipeline of concrete actions: 'Reproduce → minimise → hypothesise → instrument → fix → regression-test' — comprehensive coverage of the skill's workflow, matching the anchor 'lists multiple specific concrete actions; comprehensive coverage'. It is not a 4 because no meaningful action from the body's workflow is missing from the description.

5 / 5

Completeness

It explicitly answers both what ('Disciplined diagnosis loop for hard bugs and performance regressions' plus the six-stage pipeline) and when ('Use when user says diagnose this / debug this, reports a bug, says something is broken/throwing/failing, or describes a performance regression') with concrete trigger phrases — a direct match for the 5 anchor.

5 / 5

Trigger Term Quality

Triggers include natural user phrases ('diagnose this', 'debug this', 'reports a bug', 'something is broken/throwing/failing', 'performance regression'), which covers the direct asks well. It falls short of the 5 anchor because common synonyms like 'crash', 'error', 'not working', or 'why is this slow' are absent.

4 / 5

Distinctiveness Conflict Risk

It has a clear niche (disciplined diagnosis of hard bugs/perf regressions) with distinct explicit triggers. Not a 5 because 'reports a bug' and 'something is broken/failing' are broad enough to overlap with a generic debugging or fix-it skill, so minor overlap risk remains.

4 / 5

Total

18

/

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

coder/agent-tty

Path

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