Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add laguagu/claude-code-nextjs-skills --skill ai-sdk -a claude-code
Open on GitHub

What 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 generateText or streamText matching 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-code

2Manually: put the files in place

~/.claude/skills/ai-sdk/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/ai-sdk/

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.

ai-sdk vercel Teaches your coding agent to use the Vercel AI SDK accurately. It forces the model to read installed package docs instead of relying on memory. CX Codex +1 70,700installs ai-sdk official Vercel Labs Provides Vercel AI SDK guidance for your coding agent. Helps build chat interfaces, streaming routes, tool calls, and agents without obsolete syntax. CX Codex GP ChatGPT +1 22installs ai-sdk-expert carlrannaberg ai-sdk-expert — a Claude Code subagent for Vercel AI SDK v5 projects. It diagnoses streaming, tool calls, provider setup, and v4 migration work. CX Codex ★ 763repo stars vercel-development Mindrally vercel-development — a rule set that steers your coding agent toward Next.js App Router, React Server Components and the Vercel AI SDK. Useful when the agent keeps reaching for client components by reflex. CX Codex +1 756installs ai-sdk-6-skills gocallum This skill gives coding assistants patterns for AI SDK 6 Beta, covering agent loops and Groq setups. It speeds up migration from v5. CX Codex +1 484installs workflow Vercel Inc. Builds durable, resumable tasks with the Vercel Workflow SDK when operations must survive server restarts or pause for external events. CX Codex +1 5,500installs vercel-ai-sdk wsimmonds Walks your agent through Vercel AI SDK v5 code: useChat chat, streaming, tool calling, embeddings. CX Codex +1 348installs json-render official Vercel Labs json-render guides rendering of AI SDK v6 UIMessage parts, tool call results, and streaming states in custom React chat interfaces. CX Codex GP ChatGPT +1 4installs

From the same set13

The whole set →
next-best-practices The next-best-practices Claude Code skill applies Next.js App Router practices while writing or reviewing code. It covers hydration bugs, RSC boundaries, async APIs, and data handling. CX Codex +1 286installs postgres-semantic-search The postgres-semantic-search Claude Code skill builds and tunes PostgreSQL retrieval. It covers semantic and hybrid search, evaluation, and troubleshooting weak results. CX Codex +1 227installs cache-components A skill for mastering Next.js Cache Components and Partial Prerendering in version 16.4+. Advises on the use cache directive, setting cache lifetime with cacheLife(), tagging data with cacheTag(), and invalidating via updateTag(). CX Codex +1 222installs ai-sdk-6 ai-sdk-6 — a skill for projects already on Vercel AI SDK v6. Covers building agents, chatbots, tool integrations, streaming responses and structured output with patterns specific to the v6 API. CX Codex +1 218installs ai-app A skill for Claude Code sets up full-stack Next.js AI applications with AI SDK and shadcn/ui. Activates when generating chatbots, agent dashboards, and custom AI tools. CX Codex +1 198installs nextjs-chatbot nextjs-chatbot guides a production web chat in Next.js: tool approval, saved conversations, rendered tool results, follow-up suggestions and an embeddable widget. CX Codex +1 161installs hetzner-cloud This Claude Code skill manages Hetzner Cloud resources through the hcloud CLI. It activates for Hetzner requests, location codes, or VPS work in a project already hosted there. CX Codex +1 125installs go go — a Claude Code skill that launches the web app and verifies UI changes in a real browser. Smoke tests functional behavior, console errors, and HTTP failures. CX Codex +1 112installs

Project sponsors

Companies that keep this analytics open