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 orchestration skill with strong validation checkpoints, but it is dense and padded with duplicated guidance and lacks any progressive disclosure to offload detail into reference files.
Suggestions
De-duplicate the subagent reliability guidance (back-off timing, WORKING/BLOCKED signals, 'treat a running child as alive', fallback conditions) — state it once and reference it, instead of repeating it near-verbatim across the tool-compatibility and subagent-reliability sections.
Move the OpenCode→Codex tool-translation table, the 9 ultraqa class definitions, and the boulder.json/DoneClaim/AdversarialVerify JSON schemas into separate reference files under ./references/ and link to them one level deep to reduce the monolithic body.
Quarantine the time-sensitive surface-version note ('verified 2026-07-11: only fork_turns/message/task_name') into a clearly marked compatibility/deprecated section so stale date markers do not dilute the core instructions.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient but padded: the subagent back-off/WORKING/BLOCKED/fallback guidance is duplicated nearly verbatim across 'Codex Harness Tool Compatibility' and 'Codex Subagent Reliability', 'this section wins' is repeated three times, and an inline time-sensitive date ('verified 2026-07-11') is not quarantined in a deprecated section. | 2 / 3 |
Actionability | Highly concrete and copy-paste ready — exact commands ('git worktree add', 'git worktree list --porcelain', the web-terminal-visual-qa invocation), explicit JSON schemas (boulder.json, DoneClaim/AdversarialVerify), and required ledger fields — meeting the fully executable anchor. | 3 / 3 |
Workflow Clarity | A clear Phase 1–5 + Completion sequence with explicit validation gates (the five-gate Phase 4, Global Review and Debugging Gate) and feedback loops (non-confirmed verdict → re-dispatch; review failure → debugging skill → rerun), appropriate for the destructive/PR/merge operations involved. | 3 / 3 |
Progressive Disclosure | Well-sectioned with headers but monolithic: no bundle files exist and content that could be split out (the OpenCode→Codex tool table, the 9 ultraqa classes, the JSON schemas, the DoneClaim contract) is all inline in a ~200-line body, rather than one-level-deep references. | 2 / 3 |
Total | 10 / 12 Passed |