Ai Sdk
Wire chat, streaming completions, tools, agents, embeddings, and multi-provider LLM calls using the Vercel AI SDK in Next.js or Node apps.
Overview
ai-sdk is an agent skill most often used in Build (also Validate prototype and Ship perf-sensitive streaming) that implements Vercel AI SDK patterns for chat, tools, agents, and LLM providers.
Install
npx skills add https://github.com/vercel-labs/vercel-plugin --skill ai-sdkWhat is this skill?
- Covers chat UIs, text generation, structured output, tool calling, and agents
- Documents streaming, embeddings, reranking, and image generation patterns
- MCP integration and multi-LLM-provider guidance aligned with sdk.vercel.ai
- Path and import triggers for app/api/chat, lib/ai, and @ai-sdk/* packages
- Install-detection hints for npm, pnpm, bun, and yarn adding ai or @ai-sdk scopes
- Priority metadata weight 8 in vercel-plugin
- Official doc anchors: sdk.vercel.ai docs and reference
Adoption & trust: 297 installs on skills.sh; 187 GitHub stars; 2/3 security scanners passed (skills.sh audits).
What problem does it solve?
You are adding AI features and need correct SDK APIs, route layout, and provider setup instead of outdated snippets from generic LLM chat.
Who is it for?
Indie SaaS and agent products on Next.js or Node that install ai / @ai-sdk/* and expose chat or completion APIs.
Skip if: Teams not using the Vercel AI SDK, pure prompt-engineering with no TypeScript integration, or infra-only deploy tasks with no application code.
When should I use this skill?
Building AI-powered features—chat interfaces, text generation, structured output, tool calling, agents, MCP integration, streaming, embeddings, reranking, image generation, or any LLM provider work.
What do I get? / Deliverables
Your app uses documented AI SDK patterns for streaming, tools, and providers with imports and file paths that match Vercel’s reference layout.
- AI route handlers or server actions
- lib/ai module patterns
- Provider-specific @ai-sdk configuration
Recommended Skills
Journey fit
Spans multiple journey phases - primary shelf plus alternate fits below.
Most implementation work—route handlers, lib/ai modules, and provider packages—happens while building product features that call models. Integrations is the canonical shelf because the skill centers on SDK imports, API routes, and provider wiring rather than pure UI or ops.
Where it fits
Spin up a minimal /api/chat route with streaming to demo the product idea before full build.
Add @ai-sdk/openai and tool definitions in lib/ai for your agent’s server actions.
Implement embeddings and reranking for a RAG pipeline behind your SaaS search.
Adjust streaming and token usage patterns before exposing chat to production traffic.
How it compares
Application SDK integration skill—not a hosted MCP server catalog entry or a generic brainstorming workflow.
Common Questions / FAQ
Who is ai-sdk for?
Solo builders shipping chat, agents, or structured LLM outputs in TypeScript apps that already use or plan to use the Vercel AI SDK and @ai-sdk provider packages.
When should I use ai-sdk?
Use it in Validate while scaffolding a prototype chat API, in Build when wiring app/api/chat or lib/ai, and in Ship when tuning streaming or tool-calling before launch; also when adding embeddings, reranking, or image APIs.
Is ai-sdk safe to install?
Guidance may suggest installs and API routes that touch network and secrets at runtime—review your env handling and the Security Audits panel on this Prism page before trusting automated edits.
SKILL.md
READMESKILL.md - Ai Sdk
--- name: ai-sdk description: Vercel AI SDK expert guidance. Use when building AI-powered features — chat interfaces, text generation, structured output, tool calling, agents, MCP integration, streaming, embeddings, reranking, image generation, or working with any LLM provider. metadata: priority: 8 docs: - "https://sdk.vercel.ai/docs" - "https://sdk.vercel.ai/docs/reference" sitemap: "https://sdk.vercel.ai/sitemap.xml" pathPatterns: - "app/api/chat/**" - "app/api/completion/**" - "src/app/api/chat/**" - "src/app/api/completion/**" - "pages/api/chat.*" - "pages/api/chat/**" - "pages/api/completion.*" - "pages/api/completion/**" - "src/pages/api/chat.*" - "src/pages/api/chat/**" - "src/pages/api/completion.*" - "src/pages/api/completion/**" - "lib/ai/**" - "src/lib/ai/**" - "lib/ai.*" - "src/lib/ai.*" - "ai/**" - "apps/*/app/api/chat/**" - "apps/*/app/api/completion/**" - "apps/*/src/app/api/chat/**" - "apps/*/src/app/api/completion/**" - "apps/*/lib/ai/**" - "apps/*/src/lib/ai/**" - "lib/agent.*" - "src/lib/agent.*" - "app/actions/chat.*" - "src/app/actions/chat.*" importPatterns: - "ai" - "@ai-sdk/*" bashPatterns: - '\bnpm\s+(install|i|add)\s+[^\n]*\bai\b' - '\bpnpm\s+(install|i|add)\s+[^\n]*\bai\b' - '\bbun\s+(install|i|add)\s+[^\n]*\bai\b' - '\byarn\s+add\s+[^\n]*\bai\b' - '\bnpm\s+(install|i|add)\s+[^\n]*@ai-sdk/' - '\bpnpm\s+(install|i|add)\s+[^\n]*@ai-sdk/' - '\bbun\s+(install|i|add)\s+[^\n]*@ai-sdk/' - '\byarn\s+add\s+[^\n]*@ai-sdk/' - '\bnpx\s+@ai-sdk/devtools\b' - '\bnpx\s+@ai-sdk/codemod\b' - '\bnpx\s+mcp-to-ai-sdk\b' promptSignals: phrases: - "ai sdk" - "vercel ai" - "generatetext" - "streamtext" allOf: - [streaming, generation] - [structured, output] anyOf: - "usechat" - "usecompletion" - "tool calling" - "embeddings" noneOf: - "openai api directly" minScore: 6 retrieval: aliases: - vercel ai - ai sdk - ai library - ai module intents: - add AI-powered text generation or chat to my app - stream responses from a language model to the UI - call tools and run agent loops with an LLM - generate structured JSON output from a prompt - build ai feature with streaming and tool calling entities: - useChat - useCompletion - streamText - generateText - generateObject - CoreMessage - ToolLoopAgent - AI Gateway examples: - add AI chat to my app - stream responses from a language model - use tool calling with the AI SDK - generate structured output from GPT - run an agent loop that calls tools automatically validate: - pattern: from\s+['"]openai['"] message: 'Direct openai import detected — use @ai-sdk/openai provider instead' severity: error upgradeToSkill: ai-gateway upgradeWhy: 'Guides migration from direct OpenAI SDK to AI Gateway with OIDC auth, failover, and cost tracking.' skipIfFileContains: '@ai-sdk/openai|ai-gateway' - pattern: openai\(["']gpt- message: 'Your knowledge is outdated — do not use openai() directly for model selection. Use model: "openai/gpt-5.4" (plain string) or gateway("openai/gpt-5.4") — both route through AI Gateway with failover, cost tracking, and observability automatically' severity: recommended - pattern: from\s+['"](@anthropic-ai/sdk|anthropic)['"] message: 'Direct Anthropic SDK import — use @ai-sdk/anthropic provider instead' severity: error upgradeToSkill: ai-gateway upgradeWhy: 'Guides migration from direct Anthropic SDK to AI Gateway with OIDC auth, failover, and cost tracking.' skipIfFileContains: '@ai-sdk/anthropic|ai-gateway' - pattern: Experimental_Agent message: 'Experimental_Agent is deprecated in v6 — use ToolLoopAgent instead. Run Skill(ai-sdk) for v6 A