Content
92%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-crafted, instruction-only skill body with a tightly sequenced workflow, hard gates, concrete executable commands, and a calibration feedback loop. It assumes Claude's competence throughout; only minor conciseness gains are available in the extended framing prose.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean and assumes Claude's competence — it never explains what a proposal or postmortem is — but the nine lenses and extended framing on the three-review distinction add length that could be trimmed without losing the load-bearing guidance. | 4 / 5 |
Actionability | Fully actionable: concrete commands (`exec("cat proposals/0003-feature.md")`, `grep -rln`, `write({document:{path:...}})`), a four-part finding template with severities, and specific lens questions each paired with the failure they catch. | 5 / 5 |
Workflow Clarity | A clear Step 0–Step 6 sequence with hard gates ('never review a design you have not read end to end'), an explicit reconstruction checkpoint before critique, and an adversarial calibration step with falsifier-per-finding validation before delivery. | 5 / 5 |
Progressive Disclosure | Single self-contained file with no bundle references needed; well-organized into clearly headed sections (Steps 0–6, Non-goals) that function as a clean overview with easy navigation — the simple-skill exception applies cleanly. | 5 / 5 |
Total | 19 / 20 Passed |