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.
The body is highly actionable with concrete commands, tool contracts, and explicit validation feedback loops for a durable-state workflow. Its weaknesses are length/repetition across sections and inlining of reference-grade material that could be split into bundle files for better progressive disclosure.
Suggestions
Consolidate the repeated template/pack-selection and 'fill the generated plan, don't replace it' guidance into a single authoritative section and cross-reference it elsewhere to cut redundancy.
Move the full goal-plan schema block and the template-quality bar into dedicated bundle files under assets/ (e.g., assets/templates/goal-plan-schema.md) and link to them from SKILL.md to improve progressive disclosure.
Add explicit 'See <path> for details' navigation cues beside the script command references so the bundle files function as clear drill-down targets.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~1258-line body is largely unique domain policy Claude would not already know, but it repeats the same guidance several times — template/pack selection and 'fill the generated plan, don't replace it' each appear across multiple sections — so it could be tightened. | 3 / 5 |
Actionability | Provides copy-paste-ready bash commands with concrete flags, exact tool contracts (get_goal/create_goal/update_goal status values), a tool-objective shape template, and ready closeout/blocked report shapes covering the common cases. | 5 / 5 |
Workflow Clarity | Multi-step flows (Start Workflow, Completion Gate Policy, Repair workflow, Resume Protocol) are explicitly sequenced with validation checkpoints and feedback loops such as check-complete.mjs as the final mechanical gate and 'verify unfinished plans still fail the checker'. | 5 / 5 |
Progressive Disclosure | Section structure is clear and referenced bundle files (scripts/, assets/templates/) genuinely exist, but reference-grade content like the full goal-plan schema and template-quality bar is inlined in SKILL.md and script references are command invocations rather than well-signaled 'see X for details' navigation. | 3 / 5 |
Total | 16 / 20 Passed |