Content
88%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 exceptionally disciplined instruction-only skill: a lean overview that delegates detail to real, well-signaled reference files, with concrete blocked conditions and an exact output/protocol contract. The only structural gaps are an orphaned script and a contract file not directly reachable from SKILL.md.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and directive with zero concept explanations — "Determine whether the implementation solves the stated problem. Be adversarial about evidence. Stay inside the task's scope." assumes Claude's competence throughout. The read-only constraint is stated several times ("Remain read-only. Never edit code, tests, plans, or state.", "Never edit or write.", "Do not edit the controller database."), which is minor repetition that could be trimmed, matching anchor 4 rather than 5. | 4 / 5 |
Actionability | Guidance is fully executable for an instruction-only skill: exact blocked conditions ("If the model matches the work model, return `blocked`"), exact output contract ("Return only the `factory.review.v4` template in references/output.md. Do not emit a JSON object. Do not wrap the result in a Markdown fence."), and exact protocol handling ("call `subagent_done` once", shutdown-reply behavior). No gaps; every branch has a concrete instruction. | 5 / 5 |
Workflow Clarity | A clear three-stage sequence — isolate the session, review the task, return the verdict — with explicit validation checkpoints up front (model mismatch, mutation tools present, missing packet/diff each produce a named `blocked` outcome) and an error-recovery protocol for the shutdown edge case. Not a destructive/batch operation, so no validation cap applies. | 5 / 5 |
Progressive Disclosure | The body is a clean overview with well-signaled, one-level-deep markdown links to references/reviewer-prompt.md, references/code-quality.md, and references/output.md, all of which exist. Scored against the actual bundle: references/review-contract.md is only reachable via a second hop from reviewer-prompt.md and is never linked from SKILL.md, and scripts/review-packet.py (plus its test) is orphaned with no navigation path — minor organization gaps that fit anchor 4 rather than 5. | 4 / 5 |
Total | 18 / 20 Passed |