Skip to main content
skill CX Codex

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

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

What 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-code

2Manually: put the files in place

~/.claude/skills/tanstack-ai-migration/SKILL.md

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

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

Similar skills

All skills for AI and ML →

From the same set2

Project sponsors

Companies that keep this analytics open