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 dense, highly actionable operational checklist: every step has executable commands with exact filters, explicit block conditions, validation checkpoints, and error-recovery loops, including a well-specified commit-carry procedure. The main improvements are removing the duplicated /test-binding and Warden explanations and moving the CI-workflow background out of the main file into a reference.
Suggestions
Deduplicate the /test head-binding semantics and Warden fork behavior, which are explained both in the intro (lines 20-51) and again in sections 3 and 7; state each once and cross-reference.
Move the CI-machinery background (contributor-pr.yml / contributor-warden.yml behavior and the three screen-status meanings) into a reference file such as references/fork-ci.md, leaving SKILL.md as the checklist proper with a one-line pointer.
Surface the Warden security-review verification (section 3) and full-diff reading (section 4) in the frontmatter description so the skill's complete action list is visible before loading.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Nearly all content is repo-specific operational knowledge Claude cannot infer (workflow filenames, screen statuses, DCO/CLA policy, carry rules), so most tokens earn their place. However, the /test head-binding semantics and Warden's fork behavior are each explained twice (intro plus sections 3 and 7), which is minor over-explanation that could be trimmed — anchor 4 rather than 5. | 4 / 5 |
Actionability | Fully executable throughout: copy-paste-ready gh/git commands with exact jq filters and grep patterns (e.g. the check-runs query in section 3, the IPC/network/dependency greps in section 5, the complete cherry-pick carry sequence in section 6), each paired with explicit decision rules for outcomes. Matches anchor 5; specific examples cover the common cases. | 5 / 5 |
Workflow Clarity | Seven clearly sequenced sections with explicit validation checkpoints ("Anything doubtful -> Blocked", "contributor-pr/warden not success on that head -> Blocked", stale-head rerun of sections 1/3/4/5) and genuine feedback loops (blocked screens require contributor fixes; AI-screen refusal paths; carry authorship verification after cherry-pick). The mandatory OK/Blocked/N/A checklist in section 7 matches anchor 5. | 5 / 5 |
Progressive Disclosure | Good structure: well-organized numbered sections, clearly signaled commands, and one clearly-labeled external reference ([deployment and security caveats](../../../docs/fork-contributor-ci.md)). But the ~55-line CI-machinery background in the intro (contributor-pr.yml, contributor-warden.yml, screen status semantics) is inline content that could live in a reference file, keeping SKILL.md closer to an overview — anchor 4's 'minor organization gaps'. | 4 / 5 |
Total | 18 / 20 Passed |