Content
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The content is highly actionable with a clear, well-gated workflow and good progressive disclosure through one-level-deep shared references. Its main weakness is conciseness: the privilege-boundary and 'never apply' messages are over-elaborated and repeated across multiple sections.
Suggestions
Consolidate the privilege-boundary / 'never apply' messaging into a single authoritative section and remove its restatements in Steps 4, 5, 6, and Key Rules to cut redundant tokens.
Tighten the privilege-boundary section by trimming hedging prose ('be honest about the layers', the extended deliberate-write caveats) into a brief 'closed vs. deferred' list, keeping the concrete hook recommendation.
Move the long model-delta / harness-diet rationale in Step 1 into a shared reference and keep only the decision rule inline, reducing body length while preserving the guidance.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient and actionable but padded: the privilege-boundary section and the 'never apply / landing is separate' point are restated across Steps 4, 5, 6, and Key Rules with heavy hedging ('be honest about the layers', extended caveats), so it could be tightened — matching the score-2 anchor of mostly-efficient with some unnecessary explanation. | 2 / 3 |
Actionability | Provides fully executable, copy-paste-ready guidance: bash data-availability checks, a python json.dumps ledger snippet, concrete diff examples, a fully-specified codex MCP review call, and a structured report template — matching the score-3 anchor. | 3 / 3 |
Workflow Clarity | A clear Step 0–6 sequence with explicit validation checkpoints (data-availability guard, bottleneck naming/ledger, cross-model advisory review, acceptance-gate reference, staging manifest) and feedback loops for insufficient data and model bumps, matching the score-3 anchor. | 3 / 3 |
Progressive Disclosure | The body is an overview that pushes detail to well-signaled, one-level-deep references (shared-references/*.md, meta-apply SKILL.md, hooks, templates) via clear markdown links, with content appropriately split rather than deeply nested — matching the score-3 anchor. | 3 / 3 |
Total | 11 / 12 Passed |