Content
75%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-structured, disciplined body whose central design — distrust memory, verify everything against the installed version's bundled docs — is both non-obvious and consistently enforced, with executable commands and a type-check feedback loop. Weaknesses are mild: some repeated warnings, a slightly redundant introductory section, and no worked example of searching the bundled docs.
Suggestions
Merge the duplicated memory-distrust warnings ('Do Not Trust Your Own Memory' and 'Never use model IDs from memory' in Choosing a Model) into one stated principle referenced once, trimming the token cost.
Cut or compress the 'What the AI SDK Is' opening, which mostly restates what Claude already knows about the package, down to the one non-obvious fact (docs ship inside node_modules).
Add one concrete example of searching the bundled docs (e.g. a grep command against node_modules/ai/docs/) so the doc-verification workflow has a fully executable first step.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and imperative and assumes competence ("Never write AI SDK code from memory"). Minor over-explanation remains: the memory-distrust warning is repeated across 'Do Not Trust Your Own Memory' and 'Choosing a Model' ('Never use model IDs from memory'), and the 'What the AI SDK Is' opening restates broadly known facts. Efficient with minor trim opportunities — anchor 4. | 4 / 5 |
Actionability | Contains executable, copy-paste commands (curl for the model list, 'npm view ai version', concrete node_modules/ai/docs/ paths including monorepo variants). No TypeScript examples, but omitting them is the skill's explicit, justified strategy — code from memory would contradict its version-matched-docs rule. Anchor 4: mostly executable with minor gaps (e.g. no example of grepping the bundled docs). | 4 / 5 |
Workflow Clarity | A clear sequence runs verify-install → read version-matched docs → implement → 'Run the project's type checker', with a feedback loop ('re-check the current docs and source when they occur') and an explicit installed-vs-latest version comparison. No destructive or batch operations, so no validation cap applies; it stops short of anchor 5's full validate→fix→retry checkpoints and checklists. | 4 / 5 |
Progressive Disclosure | No bundle files exist; the body is well-sectioned and delegates all version-sensitive detail one level deep to the installed package's docs (node_modules/ai/docs/) and ai-sdk.dev URLs — an appropriate split for a fast-moving SDK. Above the under-50-line simple-skill carve-out, so anchor 4 ('good structure; most content appropriately placed; references mostly clear') fits best. | 4 / 5 |
Total | 16 / 20 Passed |