Content
92%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 well-engineered instruction skill: four input routes clearly sequenced with explicit validation steps and a flag-and-ask feedback loop, copy-paste-ready Gherkin and output templates, and proper progressive disclosure to three real one-level-deep references. The only trimmable material is minor background explanation (ISTQB ATDD definition, declarative-vs-imperative primer).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with load-bearing material — routing table, worked Gherkin blocks, numbered procedures, an output template — with almost no padding of concepts Claude already knows. It is not 5 because a few spots explain known material (the quoted ISTQB definition of ATDD, the declarative-vs-imperative primer) that could be trimmed; it is not 3 because those instances are minor and every section carries skill-specific method rather than generic tutorial prose. | 4 / 5 |
Actionability | Guidance is fully executable for an instruction-only skill: copy-paste-ready Gherkin templates for each input shape, a fully specified markdown output template, concrete rewrite rules ("remove UI mechanics, collapse multi-step UI sequences into one business action..."), and exact stub guidance ("bodies raise NotImplementedError"). The common cases (story, AC list, manual steps, raw spec) are each covered by a worked example; there are no pseudocode-only sections. | 5 / 5 |
Workflow Clarity | Each input shape has a clearly sequenced numbered workflow, and validation is explicit throughout: "Validate: at most one When per scenario; lint; specificity preserved", "Validate observability of every Then". The flag-and-ask pattern ("The Gherkin Feature can't be authored without these answers") is a genuine feedback loop, and the anti-patterns table acts as a checklist. This matches the top anchor rather than 4, where checkpoints would be merely present rather than paired with a halt-and-recover loop. | 5 / 5 |
Progressive Disclosure | The body is a clear overview that keeps actionable summaries inline while pushing deep detail to three real, one-level-deep reference files (atdd-traceability.md, manual-step-rules.md, spec-extraction-examples.md — all present in references/ and containing no further nested .md links). Each link is well-signaled with a description of its contents, and a References section repeats them with annotations. Content is appropriately split and navigation is easy, matching the top anchor. | 5 / 5 |
Total | 19 / 20 Passed |