Install any skill in seconds. Free to start, no credit card required.
Get Started Free →kytixo/skill-doctor
Audit a skill against Pocock's write-a-skill spec and return a prioritized, diagnose-only fix report.
Passed 1 of 8 test cases with the skill, and 2 of 8 without it.
and 2 more in the full report
1 fixed3 passed either way15 still failing3 broke
Tokens, turns and time describe resource use, not a dollar price.
A test case the skill fixed. Same model, same prompt, with and without the skill.
Diagnose `./skills/logger/SKILL.md` and list the breakdown of checks performed.
| Checked | Without skill | With skill |
|---|---|---|
| The evaluation includes checks under Invocation. | Missed | Passed |
| The evaluation includes checks under Structure. | Missed | Passed |
| The evaluation includes checks under Steps. | Missed | Passed |
| The evaluation includes checks under Pruning. | Missed | Passed |
| The evaluation includes checks under Hygiene. | Missed | Passed |
The instructions your model reads when the skill loads.
Audits a skill against Matt Pocock's
write-a-skill(the enforced Review Checklist) andwriting-great-skills(the deeper principles). Diagnose-first — the two gates below never move.
Refactoring touches only the target skill's own directory. Never other files, never user data.
SKILL.md in full, plus any linked references/.references/checklist.md — five sections: Invocation, Structure, Steps, Pruning, Hygiene.references/report-template.md (content only).
Exception: user said with tags or include meta-params upfront → also fill
references/meta-params-template.md in the report (propose only, no writes).Invocation · Structure · Steps · Pruning · Hygiene. Full criteria live in references/checklist.md —
score every row from that file, never from memory.
Name the smell when you find it: premature completion, duplication, sediment, sprawl,
no-op, blind-guess. Tell + first fix for each: references/checklist.md § Failure-mode lookup.
Back up first: cp SKILL.md SKILL.md.bak-<date>. Then apply the report's prioritized fix list in order.
Re-check the line count and grep the leading words to confirm nothing got lost in the move.
Run only on explicit request. Default timing: after content refactor. Upfront exception:
with tags / include meta-params in the audit invocation → proposals in gate-1 report.
test cases passed, vs 2 / 8 without
More skills from the same source and nearby in the registry, with their headline benchmark lift.