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.
An unusually disciplined instruction-only skill: concrete commands, two decision tables keyed by change type, explicit validation with a feedback loop, and a well-structured reference bundle. The only real weaknesses are a handful of over-compressed run-on sentences and cross-skill paths (../verify, ../plate-ui, ../shadcn) that do not resolve inside the standalone bundle.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is rule-dense with essentially no explanation of concepts Claude already knows — every line carries a house rule, ownership decision or command. It sits below anchor 5 because a few passages could be tightened: the run-on obligation-words sentence ("It also keeps obligation words (must, may, never), uncertainty and meaningful scope limits as strong as the source says…") and overlapping bullets in "Cover the feature's actual use" that restate "give each a clear home". | 4 / 5 |
Actionability | Fully executable guidance throughout: copy-paste-ready commands ("pnpm --filter www build:source", "node tooling/scripts/check-plite-docs.mjs", "pnpm --filter www build:registry --check"), exact file paths ("content/docs/meta.json", "components/base/button.mdx"), and two decision tables keyed by changed contract and change type that cover the common edit cases. | 5 / 5 |
Workflow Clarity | A clear sequence (handle request → read page/sibling/source → apply house style → select mechanics → verify) with an explicit validation checklist (the "Verify the changed claims" table), a feedback loop ("Run applicable checks once after the final prose pass. New source changes or a failure can require another pass"), and error-recovery guidance for red CI links at HEAD. This matches the anchor-5 pattern of checklist plus validate→fix→retry. | 5 / 5 |
Progressive Disclosure | The "Select the needed mechanics" table routes each changed contract to one of four clearly signaled, one-level-deep reference files, and all four cited files (lanes.md, mdx.md, api-examples.md, plugin.md) exist in the bundle. It falls below anchor 5 because several other referenced paths — ../verify/SKILL.md, ../plate-ui/SKILL.md and the ../shadcn/apps/v4/content/docs/ corpus — do not resolve within this bundle, leaving navigation gaps. | 4 / 5 |
Total | 18 / 20 Passed |