Content
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A well-structured, highly actionable skill body that defers detail to four genuine reference files and includes validation plus error-recovery loops. Its main weakness is redundancy: the local-search-then-web-search procedure is repeated across three sections.
Suggestions
Consolidate the 'search node_modules/ai/docs and src, then ai-sdk.dev' procedure into a single Finding Documentation section and have the Critical and When Typecheck Fails sections reference it, removing the triple repetition.
Trim the restated rationale in 'Everything you know about the AI SDK is outdated or wrong. Your training data contains obsolete APIs...' to a single directive sentence, since the second sentence restates the first.
The 'Consuming Agents (Framework-Specific)' steps ('Search documentation for the framework's quickstart guide', 'Follow the framework-specific patterns') are directional rather than executable — point to a concrete starting command or the specific docs path to search.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly lean and directive, but the 'search node_modules/ai/docs and src, then ai-sdk.dev' pattern is restated across three sections (Critical: Do Not Trust Internal Knowledge, Finding Documentation, and When Typecheck Fails), so it could be tightened — matching the 'mostly efficient but could be tightened' anchor rather than the every-token-earns-its-place anchor at 3. | 2 / 3 |
Actionability | Provides copy-paste-ready, executable commands throughout — `pnpm add ai`, `grep "query" node_modules/ai/docs/`, a full `curl ... | jq` model-ID command, and `InferAgentUIMessage<typeof agent>` — satisfying the fully-executable anchor rather than the pseudocode/abstract anchor at 2. | 3 / 3 |
Workflow Clarity | The 9-step list includes an explicit validation checkpoint (step 8: 'Run typecheck after changes') and a dedicated 'When Typecheck Fails' error-recovery feedback loop (grep common-errors → search source → search ai-sdk.dev), meeting the clear-sequence-with-validation-and-feedback anchor rather than the missing-checkpoint anchor at 2. | 3 / 3 |
Progressive Disclosure | The body is a concise overview pointing to four real, substantial one-level-deep reference files (common-errors.md 445 lines, type-safe-agents.md 204, ai-gateway.md 66, devtools.md 52) via clearly signaled links and a References section, with no deep reference chains — matching the clear-overview-with-well-signaled-references anchor. | 3 / 3 |
Total | 11 / 12 Passed |