Content
93%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 instruction-only skill body: dense, executable rules with concrete examples and commands, a clear decision workflow with a confirmation gate, and clean single-file organization. The only notable gap is the absence of an explicit verify/re-validate step in the workflow sequence.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and imperative throughout — rules like "Never mix packages ignored in `.changeset/config.json` with non-ignored packages in one frontmatter" and "**never write it.**" carry operational weight with no padding. It never explains concepts Claude already knows (what a changeset is, how git works), so every token earns its place. | 5 / 5 |
Actionability | Guidance is fully executable: a copy-paste-ready changeset file with exact frontmatter, concrete commands ("Run `git status` / `git diff --name-only`"), and worked example sentences for default flips, new features, and experimental flags. The common cases are covered concretely, matching the top anchor; it is not level 4 because there are no meaningful gaps in executable detail. | 5 / 5 |
Workflow Clarity | Section 5 gives a clear numbered sequence with an explicit human-confirmation checkpoint ("Show the changeset text to whoever requested the work and get their confirmation before committing") and an uncertainty-escalation path ("Do not guess... list what is unclear and ask"). It falls short of level 5 because there is no verify-retry loop on the written artifact (e.g., re-checking the file's frontmatter against the changed packages) and the pre-release cleanup step sits outside the numbered workflow. | 4 / 5 |
Progressive Disclosure | The skill is a self-contained ~60-line body organized into five clearly numbered sections (Whether, What, Bump Level, Which Package, Workflow) with no external bundle files and no content that belongs in a separate reference. Navigation is trivial and nothing is buried, so the top anchor fits better than level 4's 'minor organization gaps'. | 5 / 5 |
Total | 19 / 20 Passed |