Content
77%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 strong, highly actionable methodology body with an exemplary gated workflow, validation checkpoints, and concrete scripts and budgets. Its two real defects are repetition of the visual-companion and gate rules, and a broken bundle: both referenced companion files (builder-check-prompt.md, visual-companion.md) are absent from the directory, leaving two workflows unexecutable as bundled.
Suggestions
Ship the referenced bundle files (builder-check-prompt.md and visual-companion.md) or inline their essentials — as bundled, both the builder check and the visual companion workflows dead-end at missing files.
Consolidate the visual-companion offer rules into the 'Visual Companion' section and reference it from the other two spots, and state the workflow order once; the current repetition costs tokens without adding guidance.
If the scripts/ directory (server.cjs, start-server.sh, etc.) is the visual companion's implementation, mention those entry points from the body so the server tooling is discoverable.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense, opinionated, and assumes Claude's intelligence (no explanations of concepts Claude already knows), but contains real repetition: the visual-companion offer rules appear in three places ('Show, don't tell', the 'Play It Back' pre-send check, and the 'Visual Companion' section) and the build-gate workflow order is stated twice (intro list and HARD-GATE). This matches 'mostly efficient but could be tightened' rather than the minor-trim level of 4. | 3 / 5 |
Actionability | For an instruction-only skill the guidance is copy-paste ready: word budgets ('about 200 words', '200-300 words'), an exact offer script ('This might be easier if I show you. Want me to open a browser tab with some mockups?'), a worked example dialogue (the bakery website question), concrete tables (Size, Red Flags), and an exact output path ('docs/superpowers/specs/YYYY-MM-DD-<topic>-design.md'). Per the rubric's code-vs-instruction note, the absence of code is not penalized. | 5 / 5 |
Workflow Clarity | A clearly sequenced multi-step process (approaches → design doc → approval → writing-plans) with explicit validation checkpoints: the builder check with three-pile triage, the HARD-GATE approval before any building, a feedback loop (one round of 'theirs' questions, doc updated, then handed over), enumerated exceptions (spikes, opt-outs), and growth handling ('If it grows mid-task, stop, say so, and step up a size'). | 5 / 5 |
Progressive Disclosure | In-file structure is good — clear section headers, well-signaled one-level-deep references ('read `visual-companion.md` in this directory', 'dispatch a fresh subagent with `builder-check-prompt.md` in this directory') — but scored against the actual bundle, both referenced files are missing (only server scripts/ exist), so navigation fails exactly where content was split out. This sits between the broken/inlined level of 2 and the well-placed level of 4; the good internal organization holds it at 3 while the dangling references block anything higher. | 3 / 5 |
Total | 16 / 20 Passed |