Content
100%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 exemplary instruction-only skill: executable commands in every phase, explicit validation checkpoints with feedback loops for each mergeStateStatus outcome, and no padding. Its self-contained structure needs no external reference files.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's competence — no git/gh basics are explained, and repo-specific facts Claude cannot know ("an architecture review, a mutation review ... take minutes, not seconds") justify their tokens. Commands carry inline comments ("# run in the background; resolves when all checks finish") instead of surrounding prose, matching the 5 anchor; the one duplicated rebase snippet appears in two genuinely distinct contexts, so nothing is trimmable enough to drop it to 4. | 5 / 5 |
Actionability | Fully executable throughout: "gh pr checks <pr> --watch --interval 30", "gh run watch <run-id> --interval 20 --exit-status", "gh pr view <pr> --json mergeStateStatus -q .mergeStateStatus", "npm run check && git push --force-with-lease", and "gh pr merge <pr> --squash --delete-branch". Every phase has copy-paste-ready commands and per-status branches cover the common cases, matching the 5 anchor rather than 4's 'minor gaps'. | 5 / 5 |
Workflow Clarity | Three clearly sequenced phases (watch → close the loop → merge) with explicit validation ("check the PR is actually mergeable before you merge"), a feedback loop ("re-check `mergeStateStatus` until it's mergeable"), and error-recovery guidance ("never end the turn silently on a failed merge"). The destructive-operation cap does not apply because validation checkpoints are present, so it matches the 5 anchor, not 4. | 5 / 5 |
Progressive Disclosure | No bundle files exist and none are needed: the skill is a single coherent workflow with numbered, well-organized sections where everything belongs inline and navigation is trivial. Per the simple-skill guidance, well-organized sections with no need for external references warrant a 5; there are no organization gaps that would justify 4. | 5 / 5 |
Total | 20 / 20 Passed |