SkillsBot.org

AI SDK Skill

ai-sdk is Vercel's official skill for the AI SDK, the TypeScript toolkit published as the ai package on npm. It tells Claude to write AI SDK code only after checking the docs and source bundled with the installed version.

  • License Apache-2.0
  • Installs 70K
  • GitHub stars 28.0K
  • Audits 2 of 3 passed

Our hands-on test, by SkillsBot.org

We asked Claude to add a streaming summary endpoint with the AI SDK

The ai-sdk skill did not make the code better. Its main rule, check the installed version instead of memory, is something plain Claude also did here: both runs installed ai 7.0.173 and used its new instructions option instead of the old system option. The real difference was direction. With the skill, the route went through Vercel's AI Gateway, with a model ID read from the Gateway's live model list and an AI_GATEWAY_API_KEY. Without it, Claude used the Anthropic provider directly with an ANTHROPIC_API_KEY, and added Zod validation, a token cap and cancellation when the client disconnects.

  • InstallWorked8 s with the skills CLI
  • Picked up on its ownYesinvoked ai-sdk
  • Time52 s58 s without the skill
  • API cost$0.22$0.15 without the skill

The task, word for word

Add an API route to this Next.js app at app/api/summarize/route.ts that takes {text} as JSON and streams back a 3-bullet summary from a Claude model using the AI SDK. I'll add my API key later, so don't try to call the model. Don't ask me questions; make reasonable choices and finish.

With the skill

Claude's report with the ai-sdk skill: a route through the Vercel AI Gateway using ai version 7

Without the skill

Claude's report without the skill: a route using the Anthropic provider with Zod validation
Claude's reports. With the skill it explains the Gateway key and how to switch to an Anthropic key; without it, it explains the validation and the Anthropic key. Full size: with the skill, without.

What it actually did

  1. Invoked the ai-sdk skill unprompted.
  2. Installed only the ai package, as the skill says, and checked it was the latest version.
  3. Fetched the model list from the AI Gateway and picked the newest Claude Sonnet model.
  4. Read the docs bundled inside node_modules/ai to confirm toTextStreamResponse and the instructions option.
  5. Wrote a 32-line route, type-checked it and explained that the only errors came from type files in node_modules.

Where it helped

  • Up-to-date API with no guessing: it read version 7's migration notes and docs before writing.
  • Explained how to switch from the Gateway to an Anthropic key in two steps.

Limits we hit

  • Plain Claude also checked the installed types and got version 7 right, so the skill's main safeguard was not needed this time.
  • The skill steers you to Vercel's AI Gateway. We asked for a Claude model and said we'd add “my API key”, which most people would read as an Anthropic key.
  • Lighter input checks than the run without the skill: no length limit, no token cap, no cancellation on disconnect.

Use it for

  • Projects already on Vercel that want one key for several model providers.
  • Agents, chat and tool-calling work where AI SDK APIs have changed between versions.
  • Questions about AI SDK functions such as streamText, ToolLoopAgent or useChat.

One run with the skill and one without, same prompt, fresh folders, Claude Code 2.1.326 in headless mode. How we test skills. Every skill we have tested.

Last updated . The ai-sdk skill is made and maintained by Vercel; SkillsBot.org is an independent directory and is not affiliated with it.

Use ai-sdk in Codex, Cursor and GitHub Copilot

ai-sdk is a standard Agent Skills folder, so the same files work in other coding agents. Name the agent when you install:

Parts of a skill that rely on Claude Code features, such as subagents or / commands, may behave differently elsewhere. Paths for each agent are in our install guide.

AI SDK Skill facts

Author
Vercel (@vercel)
Repository
vercel/ai
License
Apache-2.0
Installs
70K
GitHub stars
28.0K
First seen on skills.sh
Jan 23, 2026
SKILL.md length
768 words
Other files
None

Security audits on skills.sh:

Installs, stars, first-seen date and audits from skills.sh on November 16, 2026. SKILL.md read from GitHub the same day.

What the ai-sdk skill does

Its central instruction is "do not trust your own memory": AI SDK APIs are renamed and removed between versions, and model IDs change often. So Claude:

  1. Checks that ai is installed, and if not, installs only that package.
  2. Reads and searches the docs and source shipped in node_modules/ai/docs/ and node_modules/ai/src/, plus the docs inside any @ai-sdk/* provider packages.
  3. Falls back to ai-sdk.dev, and says so plainly if it cannot find support for an answer.

Models. The skill recommends Vercel's AI Gateway as the fastest start: one AI_GATEWAY_API_KEY and provider/model strings. It tells Claude to fetch the current model list from the Gateway instead of using model IDs from memory, and to prefer the highest version.

Agents. It says to use the SDK's own agent abstraction, such as ToolLoopAgent, rather than hand-written tool loops, and to infer the UI message type from the agent for type-safe useChat.

When it triggers

When you ask about functions like generateText, streamText, embed or tools, want to build agents, chatbots or RAG, ask about providers, streaming or structured output, or use React hooks like useChat.

Good to know

In our test plain Claude also checked the installed version and wrote current code; the skill's visible effect was routing the model through the AI Gateway. If you want a provider key such as Anthropic's instead, say so. The skill comes from the vercel/ai repository under the Apache 2.0 license. More coding skills.

AI SDK Skill: FAQ

How do I install the ai-sdk skill?

Run npx skills add vercel/ai --skill ai-sdk.

Do I need a Vercel account to use it?

No, but the skill suggests the AI Gateway first, which needs a Gateway API key. Ask Claude to use a provider package such as @ai-sdk/anthropic if you would rather use that provider's key.

Which AI SDK version does it support?

Whatever version your project has installed. The skill reads the docs that ship inside that version rather than describing a fixed one.