Content
81%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.
This is a well-engineered process skill: every phase gives concrete commands, verbatim prompts, exact paths, and templates, with validation checkpoints and feedback loops throughout. Its only real weakness is repetition (velocity-log and scope-discipline points made multiple times) and some optional playtesting guidance that inflates the body and would sit better in a reference file.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with actionable, non-obvious guidance and never explains concepts Claude already knows, but there is noticeable repetition that could be tightened: the velocity-log importance is stated three times (Phases 3, 6 twice), and the cut-scope-not-quality rule is repeated across Phases 2, 3, and the Constraints section. Fits the anchor for mostly efficient with some tightening possible; not 4 because the repetition is more than minor. | 3 / 5 |
Actionability | Guidance is fully executable: an exact shell command to run, verbatim user-facing prompts for every question, exact file paths (session checkpoint, REPORT.md, PIVOT-NOTE.md, GRAVEYARD.md), a per-language comment-syntax table for file headers, a fallback report structure, and a copy-paste graveyard entry template. Matches the anchor for copy-paste-ready guidance covering the common cases. | 5 / 5 |
Workflow Clarity | Eight clearly sequenced phases with explicit validation checkpoints: user confirmation before every write, a day-3 sunk-cost stop-and-reassess rule, a multi-turn build/fix feedback loop, a KILL soundness checklist, and complete verdict logic including the NOT ASSESSED edge case with resume instructions. Matches the anchor for clear sequencing with explicit validation, feedback loops, and checklists. | 5 / 5 |
Progressive Disclosure | Detail is appropriately deferred to clearly signaled, one-level-deep project docs (director gate files, automation modes, the report template with an inline fallback structure, config resolution). Good structure with minor gaps: the ~415-line body carries several long optional playtesting-technique passages (think-aloud, async recording, Wizard of Oz) that could be split into a reference file. Not 5 for that remaining inline bulk; not 3 because references are well signaled and content is mostly appropriately placed. | 4 / 5 |
Total | 17 / 20 Passed |