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 exceptionally actionable orchestration skill with concrete commands, decision tables, explicit validation checkpoints, feedback loops, and a real, complete reference bundle loaded conditionally by mode. The costs are a long body with some cross-section repetition of authorization/evidence rules and a few second-level reference chains.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and rule-per-sentence with no explanations of concepts Claude already knows, but authorization and evidence rules recur across sections ("explicit repair authorization" in the intro, the Authorization bullet in Outcome Contract, "explicit write authorization" in Autofix Routing) and could be merged. Efficient with minor tightening opportunities, matching the 4 anchor rather than 5's every-token-earns-its-place. | 4 / 5 |
Actionability | Guidance is copy-paste executable throughout: exact commands ("git status --short --branch -uall", "gh run view <id> --json status,conclusion", "git fetch origin pull/<n>/head:refs/tmp/pr-<n>", "bash <skill-base-dir>/scripts/run-tests.sh", "git worktree add --detach <known-good-commit>"), numeric depth thresholds ("Under 100 lines, 1-5 files"), and concrete decision tables (Mode Picker, Autofix Routing). Per the instruction-skill scoring note, the absence of program code is not penalized since the direction is fully actionable. | 5 / 5 |
Workflow Clarity | A clear ordered pipeline (Worktree Safety Preflight → Mode Picker → Project Context Extraction → Get the Diff → Scope → findings gates → Verification → Sign-off) with explicit validation checkpoints ("re-run the check that exposed the finding", regression test "must... run red on that code", isolated-worktree verification) and feedback loops for error recovery (rounds converge at three, setup-vs-product failure classification, hollow-green detection). The sign-off block is a literal checklist, matching the 5 anchor. | 5 / 5 |
Progressive Disclosure | Good structure with conditional loading via the Mode Picker table, and all 11 referenced paths (10 references/*.md files plus scripts/run-tests.sh) exist on disk and are clearly signaled. Not 5 because a few references chain a second level (mode-ship.md points on to references/project-context.md, public-reply.md, and release-surfaces.md) and the ~230-line body inlines substantial rule content that an overview-plus-references split would move out — minor organization gaps per the 4 anchor. | 4 / 5 |
Total | 18 / 20 Passed |