Content
92%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 exemplary operational skill: executable commands at every step, explicit validation and approval checkpoints, and well-structured single-file organization with clear one-level-deep references. The only ding is a handful of trimmable explanatory asides.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is overwhelmingly lean and project-specific (Auto-Tag schedule, train semantics, recovery matrix) with no padding of concepts Claude already knows, but a few asides could be trimmed, e.g. 'The `-c` and `/dev/null` keep `git` from signing the tag and opening an editor'. Minor instances of over-explanation fit the 4 anchor rather than the every-token-earns-its-place 5. | 4 / 5 |
Actionability | Fully executable, copy-paste-ready shell throughout: setup snippets, run lookup commands, candidate preview via a worktree, tag verification, and two ready-to-use Slack post templates with clearly marked placeholders (RUN=<run-id>, NEXT_SHA=<commit>). Commands cover the common cases plus recovery paths, matching the 5 anchor. | 5 / 5 |
Workflow Clarity | Monday steps 1-4 and Tuesday steps 1-6 are clearly sequenced with explicit validation checkpoints ('Only `complete` with `no_unaddressed_breaks` is clean', 'gh run watch <run-id> --exit-status', release asset verification), approval gates before every destructive operation, and a Recovery table providing feedback loops. Destructive operations all have verification, so the workflow-clarity cap does not apply. | 5 / 5 |
Progressive Disclosure | No bundle files exist, and this single-file checklist is appropriately so: a usage table for entry points, Guardrails up front, background, Setup, day-by-day procedures, Recovery, and Related sections make navigation easy, while references (RFC 0014, CI.md, release-version-selection.md, sibling skills) are clearly signaled and one level deep. Nothing that belongs in a separate file is inlined. | 5 / 5 |
Total | 19 / 20 Passed |