Content
96%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 exceptionally lean, fully operational release runbook: concrete commands at every stage, explicit stop/validation checkpoints, resume-reconciliation rules, and error-recovery loops. Its only structural weakness is that the changelog writing rules and example entry could live in a reference file like the announcement template does.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body explains nothing Claude already knows; every sentence is a repository-specific operational constraint ("Never tag a correction committed only in the detached release worktree", "Do not retry by silently moving or recreating a published tag"). It assumes competence and every token earns its place, matching the lean anchor 5 rather than the has-trimmable-over-explanation anchor 4. | 5 / 5 |
Actionability | Guidance is directly executable: a copy-paste release gate ("make format", "make check-docs", "make lint", "ASC_BYPASS_KEYCHAIN=1 make test", "./asc version"), concrete verification checks ("codesign --verify", checksum comparison, "pnpm run lint", "pnpm build", "git diff --check"), and a complete example changelog entry. This matches the fully-executable anchor 5; the only near-gap is that the annotated-tag command is described rather than spelled out, which does not rise to a minor gap given the surrounding command coverage. | 5 / 5 |
Workflow Clarity | The sequence (prove target → release gate → publish → verify consumer-visible state → changelog → announcement → cleanup) is clearly ordered with explicit validation checkpoints ("Stop on unexplained failures; do not tag around a broken gate", restart the gate if origin/main advanced) and error-recovery feedback loops for winget failures (inspect retry history, one rerun, back-off rules, "report the exact blocker instead of looping"). This matches anchor 5, including the destructive/batch validation requirement. | 5 / 5 |
Progressive Disclosure | The announcement template is correctly split into references/release-announcement.md, signaled one level deep ("Read [references/release-announcement.md](...)"), and sections are well organized. Minor gap: the ~30-line changelog writing rules plus a worked example sit inline in SKILL.md although a references directory exists, so it fits anchor 4 (minor organization gaps) rather than the fully-appropriately-split anchor 5. | 4 / 5 |
Total | 19 / 20 Passed |