Content
71%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 lean, well-structured lookup skill with executable commands and properly disclosed one-level references. Its main issues are duplicated provider-search instructions, a missing step for detecting the installed SDK version, and grep commands that need '-r' to actually work on directories.
Suggestions
Consolidate the 'Provider-Specific Information' section into the main documentation section — the grep/glob instructions for providers are already stated there — and keep only the genuinely new note about providerOptions.
Add '-r' to the grep commands (e.g., 'grep -r "your query" node_modules/ai/docs/') so they execute successfully against directories, and add a step telling Claude how to check the installed version (e.g., read 'ai' in package.json) before choosing a documentation path.
Reframe the ai@6.0.34 pin as a deprecated/legacy branch ('For older versions...') so the current-version path is the primary instruction and the version number reads as a compatibility note rather than a time-sensitive claim.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient with no conceptual padding, but the 'Provider-Specific Information' section repeats grep/glob guidance already covered ('Provider packages... also include bundled docs in their respective node_modules/@ai-sdk/<provider>/docs/ directories'), and the time-sensitive 'ai@6.0.34' version pin is not placed in a deprecated/old-patterns framing. | 3 / 5 |
Actionability | The guidance is concrete and near copy-paste ready ('grep "your query" node_modules/ai/docs/', 'glob "node_modules/ai/docs/**/*.mdx"', 'https://ai-sdk.dev/api/search-docs?q=your_query'), but the grep commands omit '-r' and would fail when run against a directory — a minor executability gap. | 4 / 5 |
Workflow Clarity | The lookup workflow is clearly sequenced with a version-gated branch and numbered steps, but it never tells Claude how to determine which version is installed (e.g., checking package.json or npm ls), leaving a small gap in the branching condition. | 4 / 5 |
Progressive Disclosure | The ~45-line body is well-sectioned with two clearly signaled, one-level-deep references ([Common Errors Reference](references/common-errors.md) and [AI Gateway Reference](references/ai-gateway.md)), both verified to exist and contain the expected content; navigation is easy. | 5 / 5 |
Total | 16 / 20 Passed |