Content
86%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A tight, well-organized instruction-only skill: it tells the reader exactly which files to scan, what patterns of weakness to look for, how to confirm suspects safely, and what to file — with no padding. The only improvement space is in making the workflow order explicit and supplying the actual issue-filing command.
Suggestions
Add the concrete command for filing issues (e.g. `gh issue create --title "..." --body "..."`) so the filing step is fully executable.
Present the process as a short numbered sequence (scan → confirm → dedupe-check → file) so the ordering and checkpoints are explicit rather than implied by section order.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every token earns its place: the one framing sentence ("A test that can't fail is worse than no test") is load-bearing, there is no over-explanation of concepts Claude already knows, and the whole body is ~35 lean lines — the top anchor for token efficiency. | 5 / 5 |
Actionability | Concrete, executable guidance throughout: a specific file glob ("every `*.test.ts` file under `src/`"), named patterns ("`it.skip`, `describe.skip`, `it.todo`"), a copy-paste issue title template, a "Done when" criterion tied to `npm run check`, and a mutation-style confirmation technique. The gap keeping it below 5 is the missing command for actually filing the issue (e.g. a `gh issue create` invocation). | 4 / 5 |
Workflow Clarity | The process reads clearly in sequence (scan → categorize → confirm via a breaking change → check open issues for duplicates → file), with genuine validation checkpoints ("To confirm a suspect test... check whether the test would still pass. Undo any change you try"; "Check the open issues first"). The batch/destructive cap does not apply since the skill is explicitly non-destructive and validation is present; it stays at 4 rather than 5 because the sequence is implied by section order rather than given as an explicit ordered workflow. | 4 / 5 |
Progressive Disclosure | The skill is under 50 lines, single-purpose, needs no external references, and is organized into clean "What to look for" / "What to file" sections — exactly the case the guidelines say can score 5 with just well-organized sections. No bundle files exist to verify, and none are needed. | 5 / 5 |
Total | 18 / 20 Passed |