Content
85%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 executable commands, a clear sequenced workflow, an explicit self-check validation checklist, and clean progressive disclosure to two real reference files. The main weakness is conciseness: the verbatim-relay/hook-blocked doctrine is repeated across several sections and could be consolidated.
Suggestions
Consolidate the repeated verbatim-relay/hook-blocked doctrine: the intro, 'Output contract', 'Hook-blocked tool calls', and 'Where the tool's stdout actually lives' all re-explain the same rule — merge them into one section with a single set of right/wrong examples.
Move the detailed blocked-run transcript examples (turn N / turn N+1 diagrams) into references/runtimes.md, keeping only the rule and one compact example inline in SKILL.md.
Tighten the 'Self-check before sending the final message' bullets into a compact checklist so the validation step reads as a checkpoint rather than three prose questions.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is information-dense and avoids explaining basic concepts Claude already knows, but the 'courier, not a co-author' / hook-blocked / verbatim-relay doctrine is restated across the intro, 'Output contract', 'Hook-blocked tool calls', and 'Where the tool's stdout actually lives' sections with overlapping examples — noticeably more than minor trimming. It is not a 4 because the redundancy is repeated across multiple sections rather than isolated instances, and not a 2 because the content is genuinely useful and not padded with elementary explanations. | 3 / 5 |
Actionability | Provides copy-paste-ready, fully executable commands for all four CLIs (e.g. `claude -p "<prompt>"`, `opencode run`, `cursor-agent -p --trust`, `codex exec`), a complete parallel `wait` block, and concrete fixes like `CLAUDECODE="" claude -p`. Placeholders for model IDs are justified by the explicit discovery guidance, so it is not a 4. | 5 / 5 |
Workflow Clarity | The 4-step workflow (Parse intent → Pick model → Build & run → Present) is clearly sequenced, and the 'Self-check before sending the final message' section is an explicit validation checklist with error-recovery guidance (auth failures, native-first no-silent-fallback, missing binary). It is not a 4 because explicit validation steps and a checklist are present rather than merely implied. | 5 / 5 |
Progressive Disclosure | The body is well-sectioned and offloads bulk detail to two real, one-level-deep, clearly-signaled reference files ([references/models.md], [references/runtimes.md]), keeping only a quick-start cheatsheet inline. It is not a 4 because navigation is clean and the reference split is appropriate rather than having only minor organization gaps. | 5 / 5 |
Total | 18 / 20 Passed |