Agent skill

Tanstack AI Migration

by TanStack in TanStack/ai

Move an app to TanStack AI from the Vercel AI SDK or raw provider SDKs, or move it off a deprecated TanStack AI API.

MITAuto-check passedDevelopment

Install Tanstack AI Migration

skills CLI
$ npx skills add TanStack/ai --skill tanstack-ai-migration -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install TanStack/ai tanstack-ai-migration --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/TanStack/ai.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/tanstack-ai-migration .claude/skills/tanstack-ai-migration && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
tanstack-ai-migration
GitHub stars
3.2k
Token cost
~680 tokens
SKILL.md length
228 words
Files
1
Skills in repo
24
Repo updated
First seen
Licence
MIT

At a glance

Move an app to TanStack AI from the Vercel AI SDK or raw provider SDKs, or move it off a deprecated TanStack AI API.

  • Someone asks whether to switch AI libraries
  • SKILL.md covers Coming from another SDK, Upgrading TanStack AI itself, Codemods and After the port
  • Calls npx, node and npm
  • Code mixes streamText

What it does

Tanstack AI Migration is an agent skill from TanStack/ai. Move an app to TanStack AI from the Vercel AI SDK or raw provider SDKs, or move it off a deprecated TanStack AI API. 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"…

Its SKILL.md is about 680 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development, covering Code migrations. It works with TanStack and Vercel AI SDK. The repository describes itself as: 🤖 Type-safe, provider-agnostic TypeScript AI SDK for streaming chat, tool calling, agents, and multimodal apps across OpenAI, Anthropic, Gemini, React, Vue, Svelte, and Solid. The licence is MIT.

When your agent uses it

  • Someone asks whether to switch AI libraries
  • Code mixes streamText
  • @ai-sdk/ with TanStack AI
  • An upgrade breaks

Example prompts

  • “migrate”
  • “switch from Vercel AI SDK”
  • “ai-sdk”
  • “/tanstack-ai-migration”

Requirements

  • Node.js

What it can do on your machine

Read from SKILL.md and the folder at commit 5a41239. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • npx
    • node
    • npm

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • tanstack.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Tanstack AI Migration loads about 680 tokens when it runs. Until then it costs about 138 tokens; SKILL.md has 228 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~138
When it runs · the whole SKILL.md, loaded when a task matches
~680

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from TanStack/ai at commit 5a41239, republished under its MIT licence (© TanStack). 228 words, ~680 tokens.

Download SKILL.mdSave it as .claude/skills/tanstack-ai-migration/SKILL.md (or your agent's skills folder).
name
tanstack-ai-migration
description
Move an app to TanStack AI from the Vercel AI SDK or raw provider SDKs, or move it off a deprecated TanStack AI API. 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:

Deprecated APIs keep working, so upgrade in steps rather than rewriting everything at once.

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. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/tanstack-ai-migration of TanStack/ai.

Open the folder on GitHubat commit 5a41239

Compare with similar skills

Tanstack AI Migration next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Tanstack AI Migration compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Tanstack AI Migration this skillTanStack/ai3.2k—~680Automated safety check: PassMIT
Build Agentchmonitor/chmonitor298—~1.8kAutomated safety check: PassGPL-3.0
CLIProxy Core Synccaidaoli/ccLoad417—~1.5kAutomated safety check: PassMIT
GitHub Commentingjuspay/neurolink143—~698Automated safety check: PassMIT
ONNX Opset Bump Checklistmicrosoft/onnxruntime22k—~12kAutomated safety check: PassMIT
Native Data FetchingCherryHQ/cherry-studio-app4k6 repos~2.9kAutomated safety check: NotesMIT

Similar skills

  • Build Agent

    chmonitor/chmonitor

    Build an AI-agent application end-to-end — from an empty repo or an existing codebase.

    298 GitHub stars~1.8k tokensUpdated 2 days ago
    AI & LLM EngineeringAuto-check passed
  • CLIProxy Core Sync

    caidaoli/ccLoad

    Syncs or audits ccLoad's CLIProxyAPI protocol-conversion core and registered provider adapters against one pinned upstream commit, then verifies the result.

    417 GitHub stars~1.5k tokensUpdated today
    DevelopmentAuto-check passed
  • GitHub Commenting

    juspay/neurolink

    How to post clean, rich, deduplicated GitHub PR review comments — suggestion blocks, multi-line anchors, markers, formatting rules.

    143 GitHub stars~698 tokensUpdated today
    DevelopmentAuto-check passed
  • ONNX Opset Bump Checklist

    microsoft/onnxruntime

    Official

    A checklist for upgrading the pinned ONNX version and opset in ONNX Runtime, covering the files to change, archive hashes, patch rebasing and release-candidate handling.

    22k GitHub stars~12k tokensUpdated today
    DevelopmentAuto-check passed
  • Native Data Fetching

    CherryHQ/cherry-studio-app

    A skill your agent uses when implementing or debugging ANY network request, API call, or data fetching.

    4k GitHub starsUsed in 6 repos~2.9k tokens
    DevelopmentAuto-check: notes
  • Migrate Core Code to Submodules

    tinyhumansai/openhuman

    Plans and carries out moving non-host-specific code and its tests from the OpenHuman core into vendored tiny submodule libraries, then releases the submodule and re-pins the host.

    41k GitHub stars~2.6k tokensUpdated today
    DevelopmentAuto-check passed

More from TanStack/ai

All 24 skills in this repo
  • I Have Adhd

    TanStack/ai

    A skill your agent uses when the user invokes /i-have-adhd, says they have ADHD, or asks for ADHD-friendly output.

    3.2k GitHub starsUsed in 5 repos~1.8k tokens
    Auto-check passed
  • PR Sweep

    TanStack/ai

    Sweep open (or listed) PRs with up to 100 parallel agents: security-scan outside contributors, rebase onto main when behind (push --force-with-lease), approve pending first-time-contributor CI when…

    3.2k GitHub stars~4.6k tokensUpdated today
    Auto-check passed
  • A skill your agent uses when wiring honcho() from @tanstack/ai-memory/honcho — a hosted memory adapter where recall is a dialectic answer over the user's representation (no discrete fragments).

    3.2k GitHub starsUsed in 1 repo~457 tokens
    Auto-check passed
  • A skill your agent uses when wiring inMemory() from @tanstack/ai-memory/in-memory — explains setup, options (embedder, extract, topK/minScore), when to pick it (dev/tests/single-process demos), and…

    3.2k GitHub starsUsed in 1 repo~448 tokens
    Auto-check passed
  • A skill your agent uses when wiring redis() from @tanstack/ai-memory/redis in production — covers client setup (ioredis or node-redis via fromNodeRedis), the storage model, client-side ranking…

    3.2k GitHub starsUsed in 1 repo~840 tokens
    Auto-check passed
  • A skill your agent uses when adding a public teaching example or a docs tutorial.

    3.2k GitHub stars~1.4k tokensUpdated today
    Auto-check passed

Questions about Tanstack AI Migration

What does Tanstack AI Migration do?

Move an app to TanStack AI from the Vercel AI SDK or raw provider SDKs, or move it off a deprecated TanStack AI API. Tanstack AI Migration is an agent skill from TanStack/ai. Move an app to TanStack AI from the Vercel AI SDK or raw provider SDKs, or move it off a deprecated TanStack AI API.

When should I use Tanstack AI Migration?

Tanstack AI Migration fits situations like: someone asks whether to switch AI libraries; code mixes streamText; @ai-sdk/ with TanStack AI; an upgrade breaks.

How do I install Tanstack AI Migration in Claude Code?

Run `npx skills add TanStack/ai --skill tanstack-ai-migration -a claude-code`. Or copy the skill folder (skills/tanstack-ai-migration in TanStack/ai) into .claude/skills/tanstack-ai-migration in your project. Claude Code loads it when a task matches its description.

How do I install Tanstack AI Migration in Codex?

Run `npx skills add TanStack/ai --skill tanstack-ai-migration -a codex`. Or copy the skill folder (skills/tanstack-ai-migration in TanStack/ai) into .agents/skills/tanstack-ai-migration in your project. Codex loads it when a task matches its description.

Can I use Tanstack AI Migration in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add TanStack/ai --skill tanstack-ai-migration -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/tanstack-ai-migration, .gemini/skills/tanstack-ai-migration, .github/skills/tanstack-ai-migration and .opencode/skills/tanstack-ai-migration in your project.

What does Tanstack AI Migration need to run?

Going by SKILL.md and its folder, Tanstack AI Migration needs the command-line tools its instructions call (npx, node and npm). Our summary lists: Node.js.

Does Tanstack AI Migration access the network?

SKILL.md names 1 domain. As links in the text: tanstack.com. This is read from the text; nothing was executed.

Is Tanstack AI Migration safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Tanstack AI Migration use?

Tanstack AI Migration is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Tanstack AI Migration use?

About 680 tokens (SKILL.md is roughly 2.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Tanstack AI Migration?

Skills that share tags, products or a category with Tanstack AI Migration: Build Agent (chmonitor/chmonitor, 298 stars), CLIProxy Core Sync (caidaoli/ccLoad, 417 stars), GitHub Commenting (juspay/neurolink, 143 stars) and ONNX Opset Bump Checklist (microsoft/onnxruntime, 22k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Tanstack AI Migration?

TanStack (a GitHub organization) maintains it in TanStack/ai, which has 3,169 GitHub stars. The repository holds 24 skills in this directory. The repository was last updated on October 7, 2026.

Source: TanStack/ai on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.