Content
100%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.
An exceptionally disciplined orchestration skill: lean phrasing, an executable run-directory script, a phased workflow with explicit validation gates and enumerated fallbacks, and clean one-level-deep reference routing verified against the actual bundle. Its only cost is density — several rules packed per paragraph — a fair trade for the token efficiency it achieves.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body contains no concept explanations or filler; every sentence is an operating rule ('Do not infer the output from the caller's identity alone', 'A function call does not establish guarantees about its uninspected implementation'), and the one long block is an executable script rather than exposition. Not the 4 anchor, since there is no trimmable over-explanation anywhere. | 5 / 5 |
Actionability | Guidance is concrete and executable: a copy-paste bash block that creates and validates $RUN_DIR, exact read triggers ('Read `references/intake.md` now'), a named dispatch protocol ('dispatch a generic subagent directly at the extraction tier, seeded with `references/agents/work-recap-scout.md`'), and enumerated common cases (empty range, empty window, no subagent primitive, dispatch failure, confirmation unavailable). | 5 / 5 |
Workflow Clarity | Four named phases run in sequence with explicit validation checkpoints and feedback loops: 'Before delivery, check every factual claim against its source' with removal of unsupported claims, fail-fast `exit 1` checks on the scratch root, docs_root validation that stops with a named error, and a consent gate on publishing ('If confirmation cannot be obtained, do not publish'). Error-recovery paths are explicitly enumerated rather than implied, so it is not the 4 anchor. | 5 / 5 |
Progressive Disclosure | The body is a lean orchestration overview that splits detail into eight real reference files, each signaled with when to read it ('before grounding, the first blocking question, or subagent dispatch'; 'now'; 'at compose time'; 'before acting'). All referenced paths exist under references/ (including the directly-referenced agents/ scouts), and grepping the reference files shows no second-level indirection chains — matching the clear-overview, one-level-deep anchor. | 5 / 5 |
Total | 20 / 20 Passed |