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 tightly written, densely prescriptive process skill: every line is an actionable rule, the workflow is clearly sequenced with validation checkpoints and failure feedback at every phase, and jargon is pipeline-specific rather than filler. The main structural weakness is that all policy detail lives inline and depends on external shared files outside the bundle.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~80-line body is dense imperative directives with zero concept explanation and no padding (e.g., "Verify identity before changing anything and recheck the remote predecessor before every push"). Every token is a rule or constraint, fully assuming Claude's competence. | 5 / 5 |
Actionability | Concrete process guidance with specific paths (`_tasks/pipeline/prs/1-analyzed/`, `2-implementing/`, `3-done/`), named artifacts (`pre_greened`, `DRIFT`, RED-to-GREEN proof), and explicit rules like "Do not run a fallback command after a failed gate to manufacture success." It stops short of anchor 5 because mechanical details (gate commands, how to refresh PR state) are deferred to the shared files and no literal commands are given. | 4 / 5 |
Workflow Clarity | Four numbered phases (reconcile → repair → validate/admit → reconcile outcome) with pervasive explicit validation checkpoints ("recheck the remote predecessor before every push", "Immediately recheck freeze, PR head, base, candidate and protected surfaces. Any movement or retarget invalidates the receipt") and clear failure dispositions (HOLD, skip held items, repair base failures in their own PR). This batch/destructive workflow has strong feedback loops throughout. | 5 / 5 |
Progressive Disclosure | Clear section structure with the five shared references signaled at the top and one level deep. It falls short of anchor 5 because the full policy content is inlined in the ~80-line body rather than split out, and the referenced `../_shared/*.md` files are not present in this bundle, so navigation cannot be fully resolved locally. | 4 / 5 |
Total | 18 / 20 Passed |