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.
An exemplary runbook: fully executable commands, a validated multi-step sequence with stop-gates and a rollback path, and dense domain-specific gotchas with essentially no filler. Content is appropriately partitioned with the companion changelog skill.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and every paragraph encodes runbook-specific gotchas rather than concepts Claude already knows — prerelease-as-build-in-progress marker, FETCH_HEAD vs. a stale remote-tracking ref, conditional makeLatest handling, tag cleanup heuristics. The only redundancy is mild repetition of confirm-with-user phrasing, which does not pull it down to anchor 4's over-explanation level. | 5 / 5 |
Actionability | Every step has a copy-paste-ready command with full flags (git fetch/show for the version check, gh release create with target/title/notes/prerelease, gh release view/edit/delete with --json fields), and the one placeholder (<remote>) is resolved by an explicit discovery procedure. Changelog work is delegated to a named companion skill rather than left vague. | 5 / 5 |
Workflow Clarity | A clearly numbered §0–§6 sequence with explicit validation gates — the Cargo version stop-gate ("must equal the version being released, or stop"), post-create gh release view verification, and post-CI verification — plus a rollback section with double confirmation and show-before-delete. The destructive-operation cap at 3 does not apply because validation and error-recovery feedback are present, matching anchor 5. | 5 / 5 |
Progressive Disclosure | Self-contained at ~119 lines with well-organized sections; changelog generation is appropriately split out to the clearly-signaled, one-level-deep greptimedb-release-note skill, and no bundle files exist to nest or mis-navigate. Matches anchor 5's clear overview with well-signaled references. | 5 / 5 |
Total | 20 / 20 Passed |