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.
The body is an unusually executable and well-sequenced process skill: exact commands, complete scripts, explicit validation and fallback paths, and correct delegation of the changing rubric to docs/REVIEW.md. Its only costs are a few long explanatory passages and a single-file layout that carries material a split into reference files might offload.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with operational specifics and no concept explanations Claude already knows, but a few justification passages could be tightened — e.g. 'Base copies come from the **merge-base**, the commit the PR branched from, not the base branch tip: that is what the PR diff is measured against...' — matching anchor 4 rather than the every-token-earns-its-place anchor. | 4 / 5 |
Actionability | Fully executable throughout: exact gh/jq commands, a complete worktree and base-copy bash script, literal verdict strings ('Verdict: BLOCKING (n)'), and the review.json payload schema with side: "RIGHT"/"LEFT" line-placement rules — copy-paste ready guidance covering the common cases. | 5 / 5 |
Workflow Clarity | Six clearly sequenced sections with explicit validation checkpoints and error-recovery loops: plugin availability check, baseline validation via git cat-file -e and merge-base --is-ancestor with a documented full-review fallback, draft-PR and show-before-post gates, exact-match label checks, and worktree prune for interrupted runs — matching anchor 5. No destructive or batch operation lacks validation, so no cap applies. | 5 / 5 |
Progressive Disclosure | With no bundle files, all detail that varies run-to-run is correctly delegated one level deep to a clearly signaled reference ('Read docs/REVIEW.md in full') and an external plugin skill, with clean section organization; however the ~150-line body keeps posting and scratch-directory material inline where a reference file split could help, matching anchor 4 over anchor 5. | 4 / 5 |
Total | 18 / 20 Passed |