Content
85%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 lean, opinionated instruction-only skill with a well-sequenced workflow, explicit validation feedback loops, concrete fallbacks for impractical test paths, and clear reporting requirements. Its only weakness is minor repetition of the when-not-to-test guidance across three sections.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Efficient and assumes Claude's competence — no basic-concept teaching — but the skip-when-impractical guidance is stated three times ('Do not force a test when it would be impractical...', 'Do not add tests when the practical signal is weak; use manual or scripted verification', 'Prefer no new test over a bad test') and could be consolidated; not a 5 due to that repetition. | 4 / 5 |
Actionability | Concrete directives throughout ('Add the smallest focused test that would have caught the bug', 'Confirm it fails for the intended reason') plus a concrete fallback list ('targeted script, manual reproduction command, browser automation, snapshot comparison, log assertion, or focused integration check'); not a 5 because 'Run relevant adjacent tests, type checks, lint, or scenario checks' remains generic and what to do when the test still fails after the fix is left implicit. | 4 / 5 |
Workflow Clarity | Clear 7-step sequence with explicit validation checkpoints ('Run the new test before fixing. Confirm it fails for the intended reason') and an explicit feedback loop ('If it passes or fails for an unrelated reason, correct the test or reproduction before editing the implementation'), plus rerun and adjacent-validation steps and an evidence-based final report. Not below 5: checkpoints, error recovery, and reporting are all present. | 5 / 5 |
Progressive Disclosure | The body is under 50 lines, needs no external references, and is organized into well-signaled sections (Workflow, If a Failing Test Is Impractical, Guardrails, Final Response) — each earning its place. This meets the simple-skill exception for scoring 5 with well-organized sections and no bundle files. | 5 / 5 |
Total | 18 / 20 Passed |