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.
A well-orchestrated instruction-only skill body: a five-phase pipeline with explicit verification gates, blocked-path error returns, and disciplined delegation to real, purpose-labeled reference files that are all present in the bundle. The only soft spot is occasional abstract prose in the consumer/interaction sections that could be tightened without losing meaning.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is ~55 lines of near-pure directive with no concept explanations Claude already knows, and each phase delegates detail to a reference file. Minor trimming is possible: the 'Consumer and interaction' section carries abstract phrasing ("Deliver a supported position in the form the intended consumer can use", "A person's request may need a brief answer or a shareable document") that could be tightened. Not score 3: there is no unnecessary explanation, only a few wordy sentences; not score 5: those wordy stretches exist. | 4 / 5 |
Actionability | Guidance is concrete and executable for an instruction-only skill: exact reference files to read at each phase ("Read references/intake.md now, before any grounding"), exact config path ("docs_root from <repo-root>/.compound-engineering/config.yaml"), exact command ("git rev-parse --show-toplevel"), and defined failure returns ("Blocked — missing context"). Not score 5: the panel/scout mechanics themselves are delegated to references rather than shown, so the body alone leaves minor execution gaps. | 4 / 5 |
Workflow Clarity | A clearly sequenced Phase 0–4 pipeline (Frame → Ground → Verify → POV → Deliver) with explicit validation checkpoints: Phase 2 is dedicated to verifying grounding with a defined failure path ("If the evidence falls short, no subject shape may return a confident result; that reference names the result each shape returns instead"), missing context returns a structured Blocked result, and an invalid docs_root stops with a named error instead of falling back. Not score 4: the checkpoints and their failure handling are explicit, not implicit. | 5 / 5 |
Progressive Disclosure | The body is a genuine overview that splits per-phase detail into one-level-deep references, each signaled with its purpose and read-order at the point of need (intake.md, boundaries.md, grounding.md, method.md, cross-model-panel.md, followup.md — all present in references/, along with scripts/cross-model-pov.sh, scripts/peer-job-runner.py, and four files under references/agents/). Not score 4: every referenced path resolves, each reference is clearly labeled with what it defines, and nothing bulk that belongs in a reference is inlined (the ce-docs-root block is short and required before any artifact path is composed). | 5 / 5 |
Total | 18 / 20 Passed |