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.
A strong, highly actionable single-file skill: executable git commands, a complete subagent prompt, and a verdict-driven workflow with explicit checkpoints. Its main imperfections are minor rhetorical padding and an inline checklist/prompt that could live in a reference file for a leaner SKILL.md.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with non-obvious material (three-dot diff semantics, `git add -N`, stacked-PR base selection, repo-specific constraints), but rhetorical flourishes like "the unit that lands is the pull request, so that is the unit worth reviewing" and "It is the *obligation* that moved, not the option" could be trimmed. Nothing explains concepts Claude already knows, so it sits above the 3 anchor but short of lean-and-efficient 5. | 4 / 5 |
Actionability | Fully executable guidance throughout: `git diff <base>...HEAD`, `git add -N .`, `git diff HEAD`, `make quality`, and a complete copy-paste subagent prompt template with placeholders and a structured output format. Commands are ready to run and cover the common cases, matching the 5 anchor. | 5 / 5 |
Workflow Clarity | Steps 1-5 are clearly sequenced with explicit validation checkpoints: the verdict table maps safe/needs-attention/risky to concrete actions (including "do NOT open the PR, wait for the user" for risky), needs-attention creates an address-then-proceed feedback loop, and `make quality` acts as a final gate. This matches the 5 anchor's explicit validation, feedback loops, and checklists. | 5 / 5 |
Progressive Disclosure | Sections are well organized (When this gate applies / Steps / Subagent Launch / After Commit) with no dead-end reference chains, but the skill is a single ~130-line file whose long subagent prompt and checklist are inlined rather than split into a reference file. Good structure with a minor organization gap fits the 4 anchor rather than the 5 anchor's appropriately-split content. | 4 / 5 |
Total | 18 / 20 Passed |