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.
Excellent content structure: a fully sequenced workflow with validation gates and an explicit error-recovery loop, copy-paste-ready commands, and clean one-level-deep progressive disclosure to four real reference files. The only notable cost is the prose-heavy nine-principle philosophy section, which justifies the skill's design at some length that a leaner statement could carry.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and almost entirely skill-specific discipline (harness contracts, artifact coupling, right-reason loop) with little that Claude already knows — above the score-3 anchor with only 'some unnecessary explanation'. A few spots could be trimmed: the nine-principle philosophy section spends tokens justifying the design ('Don't recite them — *embody* them... teach it as you work') and P9's 'Explain → confirm → act → take feedback' restates behavior already implied elsewhere, so it falls just short of the score-5 'every token earns its place' anchor. | 4 / 5 |
Actionability | Guidance is fully executable: Step 7 gives copy-paste-ready git commands (`git checkout -b prd/<author-slug>/<feature>`, `git add prds/<feature>/`), Step 6 gives the exact command (`chmod +x prds/<feature>/run-prd-test.sh` and run it), Step 0 names the derivation source (`git config user.email`), and every step points to the specific reference file that operationalizes it. This matches the score-5 anchor; score 4 would understate the concreteness of the commands and per-step file routing. | 5 / 5 |
Workflow Clarity | Steps 0–7 are clearly sequenced with explicit validation checkpoints and a feedback loop: the Step 3 decide-to-build gate, Step 6's iterate-until-every-failure-shape-matches loop with exit-code reading and wrong-reason diagnosis, and Step 7's 'With the user's confirmation'. This matches the score-5 anchor (clear sequence, explicit validation, error-recovery loop); score 4 would ignore the fully specified right-reason feedback loop. | 5 / 5 |
Progressive Disclosure | The body is a clear overview that appropriately defers detail to four real, one-level-deep references, each clearly signaled with what it contains and when to read it ('Read the two seam references before and during the conversation'; 'the two artifact references when you reach the build'). All four referenced files exist in references/ with no nested reference chains. This matches the score-5 anchor; no content that belongs in a reference is inlined in the main body. | 5 / 5 |
Total | 19 / 20 Passed |