tanstack-ai-migration — Claude Code skill: what it does
tanstack-ai-migration is a Claude Code skill that migrates apps from Vercel AI SDK to TanStack AI or upgrades version 0.x to 1.0 during library switches or package updates.
MIT 505 installs ★ 3,377 updated 2026-11-16
npx skills add TanStack/ai --skill tanstack-ai-migration -a claude-codeWhat tanstack-ai-migration does
The skill handles transitions between AI libraries and upgrades between major versions. It maps legacy functions like streamText and generateText into structured chat() calls and adapts adapters to tree-shakeable equivalents.
Execution relies on checking active package versions and running jscodeshift transforms with dry-run previews. It resolves breaking changes, deprecated UI packages, and legacy adapter shapes.
Developers run this tool when facing broken upgrades or mixed SDK imports. It eliminates manual mapping errors by referencing official migration guides and target schemas.
What it helps with
- migrate an app from Vercel AI SDK to TanStack AI
- upgrade TanStack AI packages from 0.x to 1.0
- run jscodeshift codemods for breaking changes
- replace legacy generateText calls with chat
Example prompts for the agent
- Migrate this app from Vercel AI SDK to TanStack AI
- Upgrade TanStack AI from version 0.x to 1.0
- Run the codemod to fix deprecated options
How to install tanstack-ai-migration
1Skills CLI (Vercel)
npx skills add TanStack/ai --skill tanstack-ai-migration -a claude-code2Manually: put the files in place
~/.claude/skills/tanstack-ai-migration/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/tanstack-ai-migration/
1Skills CLI (Vercel)
npx skills add TanStack/ai --skill tanstack-ai-migration -a codex2Manually: put the files in place
.agents/skills/tanstack-ai-migration/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add TanStack/ai --skill tanstack-ai-migration -a cursor2Manually: put the files in place
.cursor/skills/tanstack-ai-migration/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install TanStack/ai skills/tanstack-ai-migration2Manually: put the files in place
.github/skills/tanstack-ai-migration/SKILL.md1Skills CLI (Vercel)
npx skills add TanStack/ai --skill tanstack-ai-migration -a gemini-cli2Platform CLI
gemini skills install https://github.com/TanStack/ai --path skills/tanstack-ai-migrationManually: put the files in place
.devin/skills/tanstack-ai-migration/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add TanStack/ai --skill tanstack-ai-migration -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 tanstack-ai-migration
How to install tanstack-ai-migration in Claude Code?
Run npx skills add TanStack/ai --skill tanstack-ai-migration -a claude-code, then locate the skill file at ~/.claude/skills/tanstack-ai-migration/SKILL.md.
What does tanstack-ai-migration do?
It migrates applications to TanStack AI from alternative SDKs and upgrades older versions to release 1.0.
What is needed to run tanstack-ai-migration?
It requires a Node.js environment and jscodeshift for executing automated code transformations.
Source text
SKILL.md · MIT
---
name: tanstack-ai-migration
description: >
Move an app to TanStack AI from the Vercel AI SDK or raw provider SDKs, or
upgrade it from TanStack AI 0.x to 1.0. Use when someone asks
whether to switch AI libraries, when code mixes streamText, generateText,
generateObject, createOpenAI, or @ai-sdk/* with TanStack AI, when an upgrade
breaks, or when someone hits a renamed option, a deprecated -ui package, or an
old adapter shape. Triggers on "migrate", "switch from Vercel AI SDK",
"ai-sdk", "streamText", "upgrade TanStack AI", "deprecated",
"breaking change", "codemod".
---
# Migrating to TanStack AI
Two different jobs. Pick the one that matches the code in front of you.
## Coming from another SDK
The name-by-name mapping lives in the docs, and it is longer than any summary
that fits here:
https://tanstack.com/ai/latest/docs/migration/migration-from-vercel-ai
The shape of the change:
- `streamText` and `generateText` become one `chat()` call with a streaming
option.
- `createOpenAI(...)` becomes a tree-shakeable adapter, such as `openaiText()`
from `@tanstack/ai-openai`.
- `onFinish` and friends become middleware hooks.
- Manual SSE wiring becomes the built-in response helpers.
- `generateObject` becomes structured outputs on `chat()`.
Read the guide, then load the target API's own skill with
`npx @tanstack/intent@latest load @tanstack/ai#ai-core`. Do not port from memory: a half-remembered mapping produces
code that type-checks in neither SDK.
## Upgrading TanStack AI itself
Start with the version the app has, and the current release:
```bash
node -p "require('@tanstack/ai/package.json').version"
npm view @tanstack/ai version
```
Then read the guides for what changed:
- https://tanstack.com/ai/latest/docs/migration/v1 (0.x to 1.0)
- https://tanstack.com/ai/latest/docs/migration/migration
- https://tanstack.com/ai/latest/docs/migration/ag-ui-compliance
- https://tanstack.com/ai/latest/docs/migration/sampling-options-to-model-options
1.0 removes every API that 0.x marked as deprecated. Each one has a
replacement that already shipped in 0.x, so you can move to the replacements
on 0.x first, then bump every `@tanstack/ai*` package to 1.0 together.
## Codemods
Some renames have a jscodeshift transform. Run it straight from the repo, and
preview first with `--dry --print`:
```bash
npx jscodeshift \
-t https://raw.githubusercontent.com/TanStack/ai/main/codemods/ag-ui-compliance/transform.ts \
--dry --print src/
```
Each guide names the codemod that covers it, and what the codemod cannot reach.
Server-side rewrites are usually manual.
## After the port
Run the project's type checker. Most errors after a migration come from an API
that was remembered rather than read, so check the failing name against
`node_modules/@tanstack/ai/src/` before changing it again.
© TanStack · MIT · TanStack/ai