Content
92%Weight 40%Scale 1-3Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is a tightly written, highly actionable, well-sequenced orchestration workflow that avoids concept re-explanation and supplies concrete commands with validation checkpoints. The main weakness is a referenced bundle file (templates/orchestration-run.md) that does not exist, slightly undermining progressive disclosure.
Suggestions
Ship the referenced templates/orchestration-run.md (the run-file format) alongside references/launching.md, or inline its essential fields so the body does not depend on a missing file.
Verify every path mentioned in SKILL.md (references/ and templates/) resolves to a real bundle file before treating the skill as complete.
Consider moving the byte-identical PRP store resolver block into a shared script reference if it is duplicated across PRP skills, to keep the overview lean.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body assumes Claude's competence — it never explains what a worktree, git, or a PR is — and every line is procedure-specific (store resolver, tool names, hard rules); despite its length the density is earned for a genuinely complex multi-phase orchestration, so it is not the verbosity-penalized 2. | 3 / 3 |
Actionability | Provides copy-paste-ready executable bash (the PRP store resolver block) and concrete commands/paths ("gh pr diff <n> --name-only", "git log origin/<base>..<base>", "$PRP_DIR/orchestration/<run-id>.md") with specific tool calls, matching the fully-executable anchor; not 2 because the guidance is complete rather than pseudocode or missing key details. | 3 / 3 |
Workflow Clarity | Seven phases are clearly sequenced (Intake → Initialize → Launch → Monitor → Gates → Integrate → Close) with explicit checkpoints (the Phase 1 CHECKPOINT, "Re-check gh pr checks before the next merge") and feedback loops ("blocked report → gate it… SendMessage the decision back"); not 2 because validation checkpoints are explicit rather than implicit. | 3 / 3 |
Progressive Disclosure | SKILL.md is a clear overview with one-level-deep, well-signaled references ("read it before the first launch") to references/launching.md, which exists — but it also points to templates/orchestration-run.md, which is not present in the bundle; per the guideline to score against actual bundle structure, a missing referenced file breaks clean navigation, so it is capped at 2 rather than 3. | 2 / 3 |
Total | 11 / 12 Passed |