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.
An exceptionally well-constructed orchestration skill: every phase has explicit entry gates, exit criteria, and failure-recovery loops, and the reviewer-launch prompt and CI watcher commands are copy-paste concrete. The single deduction is repetition of the tiny-work rule, which is stated in five places and could be consolidated.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense, purely directive prose with zero padding or concept explanation (e.g., "Never point a reviewer at your own working tree"), but the tiny-work rule is restated across the Contract, §1, §2, §3, and §6, which could be trimmed. This fits the level-4 anchor (efficient with minor trimmable instances) rather than level-5 (every token earns its place) or level-3 (noticeably unnecessary explanation). | 4 / 5 |
Actionability | Guidance is fully executable for an instruction-only skill: a copy-paste reviewer-launch prompt in §3, the exact watcher command `timeout 1800 gh pr checks <n> --required --watch --fail-fast`, explicit gates ("Do not start review without `VALIDATION: GREEN`"), and named disposition states (DECLINED, TRACKED FOLLOW-UP, NOT A FINDING). Specific templates cover the common cases, matching the level-5 anchor. | 5 / 5 |
Workflow Clarity | Six numbered phases (§1–§6) are clearly sequenced with explicit validation checkpoints at every boundary ("Do not start review without VALIDATION: GREEN", "Only after review and CI are green, return ...") and explicit feedback loops: correction batches re-enter `$prp-implement` in review-correction mode, blocking fixes trigger `$prp-review --verify-corrections`, and CI failures route through CI-correction mode then re-verification. This matches the level-5 anchor. | 5 / 5 |
Progressive Disclosure | The skill is a single self-contained ~75-line file with no bundle directories (references/, scripts/, assets/ do not exist), no nested references, and numbered sections that make navigation trivial. Nothing here warrants splitting into separate files, so the well-organized single-file structure earns the top score rather than the level-4 anchor with organization gaps. | 5 / 5 |
Total | 19 / 20 Passed |