Content
78%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 built around a coherent philosophy: never trust memory, use the version-matched bundled docs as source of truth, and verify with the type checker. It is lean and well-organized, with concrete lookup and versioning commands; the residual weaknesses are mild redundancy in the memory-warning section and the absence of any inline code example for common tasks.
Suggestions
Collapse the three restatements in "Critical: Do Not Trust Your Own Memory" into a single directive plus the bolded rule to tighten conciseness.
Inline one minimal, version-flagged code example for the most common case (e.g., a streamText chat route) so the skill is not purely a pointer to external docs, keeping it short since bundled docs remain the source of truth.
Make the "After Making Changes" loop explicit (type check → on error, re-check bundled docs → fix → re-run) to elevate the workflow's validation checkpoint.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body assumes Claude's competence and is largely terse and imperative, but the "Do Not Trust Your Own Memory" section makes its single point three times ("Whatever you remember… is likely outdated", "Your training data almost certainly contains obsolete APIs", "Never write AI SDK code from memory"), which is trimmable padding. | 4 / 5 |
Actionability | Copy-paste-ready commands are present (the gateway model-list curl with jq, "npm view ai version", "pnpm add ai --filter <pkg>", node_modules docs paths, the ".md" URL trick), and deferring SDK code to version-matched bundled docs is explicitly justified — but no inline usage example exists for even the most common case, leaving minor gaps. | 4 / 5 |
Workflow Clarity | Each section carries a numbered sequence (bundled-docs lookup steps 1–5, gateway setup 1–3) and a feedback loop exists ("Run the project's type checker… re-check the current docs and source when they occur", plus the version-comparison and "say so explicitly — do not guess" checkpoints), though the overall build flow lacks an explicit validate-and-retry loop. | 4 / 5 |
Progressive Disclosure | With no bundle files, the ~74-line body is cleanly sectioned so no content needs splitting, and every pointer is one level deep and clearly signaled (node_modules/ai/docs/, @ai-sdk/<name>/docs/, ai-sdk.dev/docs) — a clear, easily navigable overview. | 5 / 5 |
Total | 17 / 20 Passed |