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-only skill: four input shapes each get concrete worked examples and validation rules, deep material is correctly factored into three one-level-deep reference files, and the flag-and-ask pattern provides a real feedback loop. The only cost is minor verbosity (a quoted ISTQB definition and light redundancy between the routing table and When-to-use section).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is example-driven and assumes Gherkin competence — no 'what is Gherkin' padding — with compact tables for routing and anti-patterns. Minor trimmable instances remain: the quoted ISTQB ATDD definition ("a collaboration-based test-first approach that defines acceptance tests…") and slight overlap between the routing table and the 'When to use' section, fitting the level-4 anchor 'minor instances of over-explanation' rather than level 5's every-token-earns-its-place. | 4 / 5 |
Actionability | Each input shape gets copy-paste-ready worked Gherkin (promo-code feature, Scenario Outline with Examples table), a compressed but concrete rule catalog ("remove UI mechanics, collapse multi-step UI sequences into one business action, replace UI properties with observable outcomes…"), and an exact output template with the side-by-side rewrite table and new-steps table. Specific examples cover the common cases, matching the level-5 anchor; this is not level 4 because there are no meaningful gaps in executable guidance. | 5 / 5 |
Workflow Clarity | Sequenced steps per input shape (Step 1-3 for stories; numbered 1-5 for ATDD, manual steps, and spec extraction) with explicit validation checkpoints ("Validate: at most one When per scenario; lint; specificity preserved"; "Validate observability of every Then") and a flag-and-ask feedback loop that halts authoring until the PM answers implicit Givens. This matches the level-5 anchor's explicit validation, feedback loops, and output-template checklist. | 5 / 5 |
Progressive Disclosure | SKILL.md is a genuine overview: each deep topic is split into a real, one-level-deep bundle file ([references/atdd-traceability.md], [references/manual-step-rules.md], [references/spec-extraction-examples.md] — all present, none nesting further references), each signaled in-section with what it contains and repeated in a References section with annotations. This matches the level-5 anchor for well-signaled one-level-deep references with easy navigation. | 5 / 5 |
Total | 19 / 20 Passed |