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.
A well-engineered procedural skill: every step is concrete, sequenced, and validated, and almost all content is non-inferable repo policy rather than padding. The only structural weakness is that everything lives inline in one file with no top-level overview or bundle split, which keeps progressive disclosure and conciseness just short of excellent.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with repo-specific policy Claude cannot infer (tag semantics, break-window versions, partner lead times, changeset summary rules), so nearly every token earns its place; only minor bits could be trimmed, e.g. the general definition 'A breaking change removes or modifies an existing API in a way that causes compile errors for consumers upgrading'. | 4 / 5 |
Actionability | Guidance is fully executable with copy-paste commands ('git diff "$BASE_COMMIT" -- ':(glob)**/api-report/*.md'', 'pnpm flub changeset add --releaseGroup <releaseGroup> --empty'), concrete decision tables for tags and council approval, and a complete @deprecated TSDoc example covering the common cases. | 5 / 5 |
Workflow Clarity | Seven clearly sequenced steps with explicit validation checkpoints ('If all changes are @internal-only... stop', 'flag any missing ones to the user', the deprecation checklist, 'show the content to the user and confirm it looks right') and a final go/no-go summary provide feedback loops and a checklist for a complex process. | 5 / 5 |
Progressive Disclosure | Step-based sections are well organized and references to repo docs (API-Deprecation.md, Beta-Break-Process.md, .changeset/README.md) are clearly signaled and one level deep, but the skill is a single ~148-line file with no overview-first structure and reference material (tag tables, break-process details) kept fully inline rather than split into bundle files. | 4 / 5 |
Total | 18 / 20 Passed |