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 instruction-only skill body: dense with repo-specific rules, concrete examples for every common case, and a workflow with explicit confirmation and escalation checkpoints. It assumes Claude's competence throughout and contains no filler or content that should be split into reference files.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every line is a project-specific rule or example ("Never mix packages ignored in `.changeset/config.json` with non-ignored packages in one frontmatter", the pi-tui exception) that Claude could not know otherwise; there is no concept explanation or padding. This matches the lean, every-token-earns-its-place anchor, not anchor 4 which requires some over-explanation to trim. | 5 / 5 |
Actionability | Guidance is fully executable: a copy-paste-ready changeset file example, concrete commands (`git status` / `git diff --name-only`), and quoted wording examples for the common cases (bug fix, default flip with escape hatch, new feature). Anchor 5's requirement that specific examples cover the common cases is met; anchor 4 would require gaps, and the only un-exampled case (experimental features) has an explicit instruction for the enable flag. | 5 / 5 |
Workflow Clarity | The workflow is a clear 5-step sequence with an explicit validation checkpoint ("Show the changeset text to whoever requested the work and get their confirmation before committing") and an error-recovery loop ("finish the parts that are clear, then list what is unclear and ask"). The destructive pre-release deletion step is preceded by a review of accumulated entries, satisfying the feedback-loop requirement; this matches anchor 5 rather than 4. | 5 / 5 |
Progressive Disclosure | This is a single-purpose policy skill with no bundle files and no content that belongs in a separate reference — all rules are appropriately inline and organized under five clearly headed sections (Whether to Write, What to Write, Bump Level, Which Package, Workflow). Per the simple-skill guidance, well-organized sections with no need for external references warrant the top score. | 5 / 5 |
Total | 20 / 20 Passed |