Content
96%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 an exceptionally lean, actionable orchestrator spec with concrete commands, clear sequencing, and validation checkpoints. Its only gap is progressive disclosure: the markdown links and scripts it points to are not bundled alongside SKILL.md.
Suggestions
Bundle the referenced files so the links resolve: add references/cma-primitives.md and references/loops-and-workflows.md (and interview-to-config.md) under a references/ directory, or adjust the link paths to match the actual bundle layout.
Include the three scripts the body instructs Claude to run (scripts/goal_state.py, scripts/goal_router.py, scripts/loop_compiler.py) in a scripts/ directory so the executable commands are runnable as written.
Verify the ../../references/ relative paths against the plugin's install location; if the references live elsewhere, note that in the body so Claude does not search for missing files.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~50-line body is dense and lean — routing table, compile command with concrete flags, pre-flight gates, hand-off contract, and forcing-question library each earn their place with no padding or explanation of concepts Claude already knows. | 5 / 5 |
Actionability | Provides copy-paste-ready executable commands ("python3 scripts/goal_router.py --out-dir ./my-agent" with documented exit codes, a full loop_compiler.py invocation with --max-iterations/--cron/--timezone/--nest-outcome flags) plus Recommend/Cite guidance per forcing question. | 5 / 5 |
Workflow Clarity | Sequences the multi-step flow explicitly (router → act on exit code → compile loop → fork to sub-skill → advance → digest) with validation checkpoints and recovery loops (exit 3 ASK → ask → re-route; exit 4 REFUSE → get one sentence → re-route) and hard pre-flight refusals. | 5 / 5 |
Progressive Disclosure | The body is a well-sectioned overview with clearly signaled one-level-deep references (cma-primitives.md, loops-and-workflows.md, interview-to-config.md, named sub-skills), but the referenced bundle files (references/*.md and scripts/*.py) are not present in the skill's bundle, a minor organization gap. | 4 / 5 |
Total | 19 / 20 Passed |