Content
92%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 orchestration skill body: a tight phase-gated workflow with verification checkpoints and explicit failure paths, lean token-efficient prose, and well-signaled one-level-deep references verified to exist. The only dimension below 5 is actionability, where a few body-level directives stay abstract because the executable mechanics are intentionally delegated to reference files.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and directive throughout — no concept explanations Claude already knows, no padding, and every sentence issues an instruction or boundary ('Stay read-only while forming and reconciling the POV', 'Nothing the conversation asserts substitutes for grounding'). Matches the anchor 'every token earns its place'; not 4 because there is no over-explanation to trim, only earned boundary-drawing. | 5 / 5 |
Actionability | Gives concrete directives at each phase ('Read `references/intake.md` now', 'return **Blocked — missing context**', 'Read `docs_root` from `<repo-root>/.compound-engineering/config.yaml`', 'Send scouts directly to candidate-specific current evidence') with an explicit blocked path. Not 5 because a few directives remain abstract at the body level ('Deliver a supported position in the form the intended consumer can use') with the real mechanics delegated to references; not 3 because nothing is pseudocode or missing key details — each step states exactly what to do next. | 4 / 5 |
Workflow Clarity | Explicit phase sequence (Phase 0 Frame → 1 Ground → 2 Verify Grounding → 3 POV → 4 Deliver) with read-gates between phases, a dedicated verification checkpoint ('Apply that check over the grounded evidence. If the evidence falls short, no subject shape may return a confident result'), and defined failure recovery (Blocked — missing context, panel-branch-before-result ordering). Matches the anchor for clear sequence with explicit validation steps and error-recovery handling; this is a read-only judgment skill, so the destructive/batch cap does not apply. | 5 / 5 |
Progressive Disclosure | The body is a concise orchestration overview that signals six reference files at the exact point of need with bold 'Read X now' directives; all referenced files (intake.md, boundaries.md, grounding.md, method.md, cross-model-panel.md, followup.md) verified to exist, and heavy content (37KB cross-model-panel.md, 109KB peer-job-runner.py) is split out of SKILL.md. Cross-links among references point only to siblings the body also links directly, so references are effectively one level deep with easy navigation — matches the anchor, not 4, since organization and signaling are consistently strong. | 5 / 5 |
Total | 19 / 20 Passed |