ai-sdk · laguagu — Claude Code skill: what it does, how to install
Skill for Claude Code that identifies the installed Vercel AI SDK major version and routes to matching API docs. Activates when working with generateText, streamText, useChat, or tools.
MIT 149 installs ★ 74 updated 2026-11-14
npx skills add laguagu/claude-code-nextjs-skills --skill ai-sdk -a claude-codeWhat ai-sdk does
This skill checks the workspace manifest or lockfile to detect versions of ai and connected provider packages. It routes AI SDK 7 tasks to ai-sdk-7, while handling v6 code via the documentation and types bundled inside node_modules.
API references are searched locally first. Package ai bundles documentation starting from 6.0.32, whereas releases from 6.0.0 to 6.0.31 lack bundled files. When offline files are missing, the skill falls back to tagged releases in vercel/ai or the ai-sdk.dev search API.
Companion packages such as @ai-sdk/react or @ai-sdk/workflow do not ship standalone docs, relying on types in dist/*.d.ts.
What it helps with
- detect the installed Vercel AI SDK major release
- configure
generateTextorstreamTextmatching installed APIs - handle server and client state boundaries with
useChat - integrate tool calls using ToolLoopAgent
Example prompts for the agent
- Help configure streamText with an OpenAI model in this project
- How do I migrate my useChat integration from v6 to AI SDK 7?
- Add a ToolLoopAgent that handles structured outputs
How to install ai-sdk
1Skills CLI (Vercel)
npx skills add laguagu/claude-code-nextjs-skills --skill ai-sdk -a claude-code2Manually: put the files in place
~/.claude/skills/ai-sdk/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/ai-sdk/
1Skills CLI (Vercel)
npx skills add laguagu/claude-code-nextjs-skills --skill ai-sdk -a codex2Manually: put the files in place
.agents/skills/ai-sdk/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add laguagu/claude-code-nextjs-skills --skill ai-sdk -a cursor2Manually: put the files in place
.cursor/skills/ai-sdk/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install laguagu/claude-code-nextjs-skills skills/ai-sdk2Manually: put the files in place
.github/skills/ai-sdk/SKILL.md1Skills CLI (Vercel)
npx skills add laguagu/claude-code-nextjs-skills --skill ai-sdk -a gemini-cli2Platform CLI
gemini skills install https://github.com/laguagu/claude-code-nextjs-skills --path skills/ai-sdkManually: put the files in place
.devin/skills/ai-sdk/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add laguagu/claude-code-nextjs-skills --skill ai-sdk -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about ai-sdk
How to install ai-sdk in Claude Code?
Run npx skills add laguagu/claude-code-nextjs-skills --skill ai-sdk -a claude-code.
What does ai-sdk do?
It determines the installed ai package version in the project and supplies code examples and documentation matching that exact major release.
Where does ai-sdk look for documentation?
It inspects local docs/ folders and type definitions inside node_modules first. If local files are unavailable, it checks tagged commits in vercel/ai or queries ai-sdk.dev.
Source text
SKILL.md · MIT
--- name: ai-sdk description: 'Answer questions about the AI SDK and help build AI-powered features. Use when developers ask about Vercel AI SDK, generateText, streamText, ToolLoopAgent, useChat, AI SDK providers, tools, structured output, embeddings or streaming, or want to add AI features to a TypeScript or JavaScript app. First identify the installed major version and route version-specific work: use ai-sdk-7 for AI SDK 7 features/migrations such as WorkflowAgent, HarnessAgent, reasoning, runtime/tools context, toolApproval, telemetry, realtime, or v6-to-v7 upgrades; for v6 code read the docs shipped in the installed package.' --- # AI SDK version and documentation routing Identify `ai` and the provider/React package versions in the relevant workspace's manifest, lockfile or installed package. Keep the installed major unless an upgrade is requested. - AI SDK 7 implementation or migration: use `ai-sdk-7`. - AI SDK 6 maintenance: read the installed package's `docs/`, types and `src/`. - Unknown, mixed or older versions: resolve them before applying either API set. - New apps: start on the current major (7 when written; `npm view ai dist-tags` confirms). `ai@7` pairs with `@ai-sdk/react@4`, `ai@6` with `@ai-sdk/react@3`. Provider majors differ per package, so install each provider's `latest` for v7 and its `ai-v6` dist-tag for v6 (`npm view <pkg> dist-tags`). ## Find the API that matches the app Search the resolved package's `docs/`, types and `src/` (when shipped) first; they work without network. `ai` bundles docs from 6.0.32 and in 7.x; 6.0.0-6.0.31 have no docs. The docs tree mirrors the website: `ai-sdk.dev/docs/<section>/<page>` is `ai/docs/<nn>-<section>/<nn>-<page>.mdx`, so an `ai-sdk.dev/docs` link in these skills can be read from the installed major's copy. Provider packages ship `docs/<nn>-<provider>.mdx` in their AI SDK 7 releases and in later v6 releases (from `@ai-sdk/openai` 3.0.16, `@ai-sdk/anthropic` 3.0.20, `@ai-sdk/google` 3.0.12, `@ai-sdk/gateway` 3.0.21); earlier v6 releases have none. `@ai-sdk/react`, `@ai-sdk/workflow`, `@ai-sdk/harness`, `@ai-sdk/otel` and `@ai-sdk/mcp` ship no docs; their guides are in `ai/docs` and their API in `dist/*.d.ts`. Monorepo hoisting and Yarn PnP may change the paths; do not install or upgrade a dependency solely to obtain docs. When local documentation is unavailable, use the matching repository tag (`vercel/ai`, tag `ai@<version>`, `content/docs/`) or docs version. The [documentation search](https://ai-sdk.dev/api/search?query=useChat) and Markdown page variants help locate the relevant feature; append `&tag=v6` (`v5`, `v6` or `v7`) to scope search results to a major. Repository main and the default website can target a newer major than the app. With neither local docs nor network, say which API facts remain unverified. Choose model IDs from the app's provider configuration or current provider catalog. The [Gateway catalog](https://ai-gateway.vercel.sh/v1/models) can aid discovery; its IDs and capability availability do not imply that another provider accepts them. ## Targeted references - [Common errors](references/common-errors.md): obsolete names and protocol mismatches. - [Typed agents](references/type-safe-agents.md): UI inference and server/client boundaries. - [DevTools](references/devtools.md): local debugging. - [Examples](references/examples.md): provider-specific official code. Use defaults when they fit. Typecheck changed integrations and exercise their streaming/tool path; a supported symbol can still be used with the wrong callback scope, result semantics or provider.
© laguagu · MIT · laguagu/claude-code-nextjs-skills
Similar skills
All skills for AI and ML →ai-sdk by other authors comes first.