Content
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
An actionable, well-sequenced review skill with concrete prompts, commands, and an explicit output format. It would tighten with less repetition across the Contract and Codex sections, and the referenced bundle files must actually be provided for progressive disclosure to land.
Suggestions
Consolidate the subagent-discovery guidance into one place; it currently appears in the Contract, 'Before You Start' step 4, and the 'For Codex specifically' paragraph.
Provide the missing references/ directory with reviewer-selection.md and reviewing.md, or inline the essential reviewer-selection criteria so the referenced paths resolve.
Trim overlapping Contract bullets that restate workflow steps (e.g. scope definition, stale-evidence handling) to reduce redundancy.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient and free of basic-concept padding, but subagent discovery is restated across the Contract, 'Before You Start' step 4, and the dedicated 'For Codex specifically' paragraph, and several Contract bullets overlap the workflow steps. | 2 / 3 |
Actionability | Provides a copy-paste subagent prompt template, concrete git commands ('git diff --stat <base>...HEAD', 'pnpm test path/to/spec'), an explicit labeled output schema, and a worked example — all directly executable. | 3 / 3 |
Workflow Clarity | Clear sequenced process (numbered 'Before You Start' 1–6 plus a four-step Workflow) with explicit validation checkpoints: 'Block when missing context or proof prevents an honest verdict' and refreshing stale CI/branch heads before judging. | 3 / 3 |
Progressive Disclosure | Sections are well-organized and references are clearly signaled one level deep, but the body points to references/reviewer-selection.md and references/reviewing.md while no references/ bundle directory exists, so the navigation path leads to missing files. | 2 / 3 |
Total | 10 / 12 Passed |