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 tight, senior-level review playbook: concrete commands, an ordered hunt list, an evidence taxonomy, a confidence gate, and a precise output template, all in ~110 well-sectioned lines with no bundle-file overhead. The only wrinkle is mild redundancy between the 'Evidence, not speculation' and 'Confidence gate' sections.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is efficient and assumes reviewer competence ('Most "looks wrong" findings die here — or get sharper'), but the 'Evidence, not speculation' and 'Confidence gate' sections partially restate the same rule about excluding unconfirmed findings. This fits anchor 4 ('minor instances of over-explanation that could be trimmed') rather than 5's 'every token earns its place'. | 4 / 5 |
Actionability | Guidance is fully executable for an instruction-only skill: concrete commands ('git diff <base>...HEAD', 'gh pr diff', 'codewhale review --pr <N> --json'), a defined severity vocabulary (blocker/concern/nit), an exact output template, and named tool invocations. Per the code_vs_instruction note, absence of code is not penalized when guidance is this actionable. | 5 / 5 |
Workflow Clarity | The hand-review workflow is a clear numbered sequence (establish the change → read callers and contracts → read error paths) with conditional fallbacks for tool availability, and the confidence gate acts as an explicit validation checkpoint with a defined escape valve ('considered, could not confirm') for unconfirmed items. This matches the 5 anchor's clear sequence with explicit validation steps. | 5 / 5 |
Progressive Disclosure | The skill is a single self-contained file with no bundle directories and no references to any; nothing is inlined that belongs in a separate file, sections are well-organized and easy to navigate, and the body appropriately delegates to the shared 'codewhale review' core rather than duplicating it. This matches the 5 anchor's 'content appropriately split; easy navigation' given there is nothing to disclose further. | 5 / 5 |
Total | 19 / 20 Passed |