Content
67%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.
The body is well-structured and actionable, with concrete file paths, templates, and a sequenced workflow that includes a validation checkpoint. Its main weakness is motivational prose that pads the token budget without adding instructional value.
Suggestions
Trim or remove the 'Why This Beats Just Don't Re-Decide' section and the pattern-matcher intro paragraph; they explain rationale Claude can infer rather than instruct action, improving conciseness.
Add a brief feedback loop to the workflow specifying what to do when the decision record lacks APPROVED status (e.g., route to /cs:boardroom or report and stop), which would close the workflow_clarity gap.
Make abstract workflow steps concrete: specify how to locate and read the decision record and how to verify APPROVED status, so every step is executable.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient with concrete tables and templates, but includes motivational rationale Claude does not need ('Founders are pattern-matchers; pattern-matching after a tough decision often produces a reversal that's actually just decision fatigue') and a 'Why This Beats Just Don't Re-Decide' section that pads the body. Not a 4 because several sentences are explanatory rather than instructional. | 3 / 5 |
Actionability | Provides concrete, copy-paste-ready guidance: exact file path ('~/.claude/freezes/active.md'), the field to write ('freeze_until: YYYY-MM-DD'), full markdown output templates, and the /cs:unfreeze command. Not a 5 because a few steps remain abstract ('Read the decision record', 'Validate it has APPROVED status') without specifying how. | 4 / 5 |
Workflow Clarity | The 5-step workflow is clearly sequenced with an explicit validation checkpoint (step 2: 'Validate it has APPROVED status') before the mutating write. Not a 5 because there is no feedback loop specifying what to do when validation fails, leaving a minor gap. | 4 / 5 |
Progressive Disclosure | Self-contained single file with well-labeled sections (When to Use, Default Freeze Periods, Workflow, Output, Override, Routing, Related) and clearly signaled cross-skill links. Not a 5 because the body slightly exceeds the simple-skill line and a couple of rationale sections could be trimmed or externalized. | 4 / 5 |
Total | 15 / 20 Passed |