Content
78%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-engineered instruction-only skill: an executable command with a defined output contract, clearly sequenced phases with error handling, and exemplary progressive disclosure that keeps checklists and criteria in verified one-level reference files with no duplication. The only improvements are minor: trim the duplicated output examples, give a concrete subagent invocation pattern, and close the fix-then-reverify loop.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is efficient — tables for principles, severity mapping, and error handling; no explanations of concepts Claude already knows; references defer detail instead of inlining it. Not 5 because the Phase 4 output template is duplicated by two full 'Output Examples' sections that restate the same format and could be trimmed to one. Not 3: the padding is limited to that one redundancy. | 4 / 5 |
Actionability | Concrete, executable guidance throughout: the exact command `node ${SKILL_DIR}/scripts/static-checks.js ${PROJECT_ROOT}`, the JSON output schema, severity synthesis rules, four explicit user options, and the commit annotation format. Not 5 because Phase 2's subagent spawning defers mechanics (how to sample the diff, how results are returned) without a concrete invocation pattern, leaving a minor gap. | 4 / 5 |
Workflow Clarity | Five phases are clearly sequenced with an error-handling table covering script failure and subagent timeout (feedback for error recovery) and an explicit user decision gate. Not 5 because Phase 5's 'Fix critical issues' path never instructs re-running verification after fixes, so the validate→fix→re-validate loop is left implicit — a minor validation gap. | 4 / 5 |
Progressive Disclosure | The body is an overview that appropriately splits detail into one-level-deep, well-signaled references (criteria.md, review-checklists.md, verification.md — all verified to exist and to contain exactly what the body claims) and script files, explicitly maintaining a single source of truth ('do not duplicate the templates here'). All referenced paths are real; co-change.md is a clearly-signaled sibling cross-link, not buried content, so navigation is easy. | 5 / 5 |
Total | 17 / 20 Passed |