Content
72%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The content is highly actionable with concrete commands and paths and is well-organized into clear sections, but it loses conciseness to near-verbatim duplication of the hook-processing logic and leaves the error-recovery feedback loop implicit. Tightening these would lift the weaker dimensions.
Suggestions
Factor the duplicated before_plan and after_plan hook-processing blocks into a single shared procedure referenced once, varying only the hook key and the optional/mandatory label wording.
Make the gate-failure error recovery explicit, e.g., 'on gate failure, document the violation, revise the design, then re-evaluate the Constitution Check until gates pass'.
Clarify the Phase 1 'Agent context update' step with the exact command or snippet that updates the CLAUDE.md markers, rather than describing the update in prose.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and free of concept-padding Claude already knows, but the before_plan and after_plan hook-processing blocks repeat ~95% identical text (~30 lines duplicated), which is a clear tightening opportunity. | 2 / 3 |
Actionability | It gives concrete, executable guidance — exact script paths, JSON keys to parse, marker-delimited edit instructions, and a precise dot-to-hyphen transform — matching 'fully executable commands; copy-paste ready.' | 3 / 3 |
Workflow Clarity | The outline and phases are clearly sequenced with prerequisites and gates, but the error-recovery loop is implicit: it says 'ERROR on gate failures' without specifying a fix-and-revalidate cycle, leaving a validation checkpoint gap. | 2 / 3 |
Progressive Disclosure | The skill is a single self-contained file organized into clearly labeled sections with no nested or deep reference chains, and no bundle files exist to mis-signal, so organization alone supports a top score. | 3 / 3 |
Total | 10 / 12 Passed |