Content
75%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-crafted, instruction-only skill body: concrete templates, explicit thresholds rules, verification checklists, and gap-flagging TODO conventions, all at ~100 lines with no bundle dependencies. Scores cluster at 4 rather than 5 due to minor padding, the absence of a worked example, and a workflow that must be assembled from separate sections rather than read as one sequence.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is efficient — templates, rules, and rationale with little padding — but a few rhetorical flourishes could be trimmed, e.g. "Subjectivity is the enemy here" and "an agent expanding scope feels like helpfulness — it has no way to know it's doing something unwanted". Not score 5: these explanatory asides, while useful, aren't all earning their tokens; not score 3: there is no genuinely unnecessary explanation of concepts Claude already knows. | 4 / 5 |
Actionability | Guidance is concrete and executable: exact file paths (`requirements/{feature-name}/`), copy-paste markdown templates for all three documents, TODO comment patterns to insert, and concrete good/bad criterion examples ("the user completes registration in under 3 steps without consulting help documentation"). Not score 5: no fully worked example of a completed document pair, which would remove remaining ambiguity about story grain and criterion phrasing. | 4 / 5 |
Workflow Clarity | The sequence is clear and includes an explicit pre-write verification checklist ("Before writing, verify: every user story has a corresponding acceptance criterion entry; no acceptance criterion is subjective...") plus developer-confirmation and TODO-flagging checkpoints. Not score 5: the workflow is distributed across Usage / The Three Documents / Where to Find Input / Output sections rather than presented as one ordered sequence, and there is no post-write re-check loop. | 4 / 5 |
Progressive Disclosure | The skill has no bundle files and stays a single ~100-line SKILL.md with well-organized, clearly headed sections; the only external pointers are to project files (`docs/functional/glossary.md`, `docs/constitution.md`), which is appropriate. Not score 5: at this length the three per-document format templates are borderline candidates for reference files, keeping the main body leaner. | 4 / 5 |
Total | 16 / 20 Passed |