Content
81%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-structured, validation-heavy review pipeline with executable bash and explicit feedback loops throughout. Its main weaknesses are minor verbosity and reliance on the sibling review-pr skill for several critical blocks rather than bundling them.
Suggestions
Inline or bundle the Step 5 verification block and Step 7 trim list (currently delegated to review-pr) so the skill is self-contained and the security-critical shell has a single source of truth within this skill's bundle.
Tighten the Trust-model and Step-3 prose sections by converting explanatory paragraphs into bulletted guardrail rules to reclaim tokens without losing the load-bearing cautions.
Add the missing verification/proof-of-work line format inline (or in a bundled reference) so agents do not have to cross-read review-pr to satisfy Step 5's REQUIRED report opening.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Dense and purposeful prose that assumes Claude's competence and only explains non-obvious gotchas (write-then-verify-then-move, two-dot-with-working-tree, `|| true` requirement); a few prose sections could be trimmed, keeping it just below the lean 5 anchor. | 4 / 5 |
Actionability | Copy-paste-ready bash for scope, charter, dispatch, and cleanup plus a concrete Agent template, but Step 5's verification block and Step 7's trim are delegated to review-pr rather than inlined, leaving minor gaps versus the fully-executable 5 anchor. | 4 / 5 |
Workflow Clarity | A clearly sequenced 7-step pipeline with explicit validation checkpoints (BASE/empty-diff guards, write-then-verify-then-move, refuse-default-branch, agent verification with retry rule, integer gate) and feedback loops for this batch/review operation. | 5 / 5 |
Progressive Disclosure | Well-organized with clear step headers and one-level-deep delegation to the sibling review-pr skill instead of duplication, but no bundle files exist and several critical blocks live in another skill rather than being bundled, leaving a minor organization gap below the 5 anchor. | 4 / 5 |
Total | 17 / 20 Passed |