Content
72%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.
The body is admirably lean and points to a real script with a clear output contract, but the workflow is effectively truncated: a promised multi-step process ends after one step with no failure handling, and the existing REFERENCE.md is orphaned. It works as a stub, not as a complete skill.
Suggestions
Resolve the workflow inconsistency: either make this explicitly a single-step skill (drop 'Process steps in order') or add the missing steps that 'Finish here.' truncates.
Add a failure branch, e.g., 'If the check exits non-zero, report the failure and stop — do not proceed.'
Reference references/REFERENCE.md from the body (e.g., 'Evidence standards: see [REFERENCE.md](references/REFERENCE.md)') or remove it from the bundle.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is roughly six lines with zero padding: 'Process steps in order. Do not skip ahead.' plus one step and its output contract. Every token earns its place and it assumes Claude's competence. | 5 / 5 |
Actionability | 'Run `skills/review-change/scripts/check.sh`' with the stated contract ('It emits `{"ok":true}` on stdout and exits non-zero on failure') is concrete and executable, but the failure path is undefined and the path is layout-dependent — mostly executable with minor gaps. | 4 / 5 |
Workflow Clarity | 'Process steps in order. Do not skip ahead.' implies a multi-step process, yet only 'Step 1 — Check the Change' exists before 'Finish here.', and no checkpoint says what to do when the script exits non-zero. Sequence is present but checkpoints are missing or implicit. | 3 / 5 |
Progressive Disclosure | The body signals the script correctly, but the bundle's references/REFERENCE.md is never mentioned in the body — a provided reference that is not clearly signaled. Scoring against the actual bundle structure, this fits 'references present but not clearly signaled'. | 3 / 5 |
Total | 15 / 20 Passed |