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.
An excellent operational skill: fully executable gh/git commands, a clearly sequenced five-step train with validation checkpoints and failure-feedback loops at every stage, and well-signaled one-level-deep cross-references. The only improvements are minor: trimming the invariant-justification and tagging-rationale prose would tighten the overview further.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and operational — commands over prose, no explanations of concepts Claude already knows — but the shared-invariant justification paragraph ("It does not weaken shared invariant §7…") and the release-tagging rationale ("an untagged bump is a release no consumer can reach…") could each be tightened by a few lines, matching the efficient-with-minor-trimming anchor. | 4 / 5 |
Actionability | Fully executable throughout: `gh pr list --state open --json number,title,isDraft,reviewDecision,mergeable,mergeStateStatus,headRefName`, `gh api -X PUT "repos/{owner}/{repo}/pulls/$PR/update-branch"`, `gh pr checks "$PR" --watch`, `gh pr merge "$PR" --merge`, `gh run watch <databaseId>`, and `git tag -a v<version> <merge sha>` — copy-paste ready commands covering the common cases. | 5 / 5 |
Workflow Clarity | A five-step procedure with explicit validation checkpoints at every risky point (per-PR green verification, checks re-run after update-branch, post-merge workflow watch) and three distinct failure-recovery feedback loops (red after update → skip → /pr-iterate; rejected merge → re-read state; failed post-merge workflow → stop, escalate), so the batch-operation cap does not apply. | 5 / 5 |
Progressive Disclosure | No bundle files exist; the single ~150-line body is well sectioned with a dedicated Cross-references section pointing one level deep to clearly signaled repo docs (`constitution/local-workflow.md`, `docs/adr/INDEX.md`). It exceeds the under-50-lines simple-skill exception, and the inline invariant/tagging justification is somewhat long for the overview, keeping it at good-structure rather than fully optimized. | 4 / 5 |
Total | 18 / 20 Passed |