Content
86%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 exemplary lean orchestration skill: dense, non-obvious guidance with explicit stop conditions, caps, and role separation throughout. The only weaknesses are the absence of an inline example of a unit dispatch and no error-handling path for a failed unit within a fan-out.
Suggestions
Add one short inline example of a unit dispatch prompt and the consolidator's merge step, since the mechanics currently require jumping out to the delegate skill.
State what to do when an individual unit dispatch fails or errors mid-fan-out (e.g., retry once, then mark that unit BLOCKED in the merge report), mirroring the existing PARTIAL/BLOCKED convention for caps.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~45-line body is dense and operational throughout — "Parallelism buys fresh context per unit and speed. It costs coordination..." — with no padding and no explanation of concepts Claude already knows; every section adds non-obvious guidance (preconditions, caps, maker/checker separation). | 5 / 5 |
Actionability | Guidance is specific and executable — "Set the cap before the first iteration (default 5). At the cap, report PARTIAL with what remains", "Route review to a different agent... with the success criteria and the artifact path", "one dispatch per unchecked item, each told to tick its own line on DONE" — but the actual dispatch mechanics and any example unit/merge prompt are delegated to the pointer files rather than shown inline. | 4 / 5 |
Workflow Clarity | Each shape carries a clear sequence with explicit checkpoints — stop conditions ("no new findings, zero errors in the gate output, no unchecked items remain"), pre-fan-out caps, and PARTIAL/BLOCKED reporting on cap hit; maker/checker and review dispatches validate batch fan-outs. The gap: no stated handling for a unit dispatch that fails or errors mid-fan-out, so error recovery is only partially covered. | 4 / 5 |
Progressive Disclosure | The body is under 50 lines with well-organized sections and no inline content that belongs in a separate file; its external references (the delegate SKILL.md and harness-notes) are one level deep and clearly signaled both inline in Preconditions and in a dedicated Pointers section. | 5 / 5 |
Total | 18 / 20 Passed |