playbooks

home / skills / petekp / claude-code-setup / ai-sdk

ai-sdk skill

/skills/ai-sdk

This skill answers questions about the AI SDK and helps build AI-powered features by guiding integration, debugging, and provider usage.

npx playbooks add skill petekp/claude-code-setup --skill ai-sdk

Review the files below or copy the command above to add this skill to your agents.

Files (2)
SKILL.md
2.2 KB
---
name: ai-sdk
description: 'Answer questions about the AI SDK and help build AI-powered features. Use when developers: (1) Ask about AI SDK functions like generateText, streamText, ToolLoopAgent, or tools, (2) Want to build AI agents, chatbots, or text generation features, (3) Have questions about AI providers (OpenAI, Anthropic, etc.), streaming, tool calling, or structured output.'
metadata:
  author: Vercel Inc.
  version: '1.0'
---

## AI SDK Documentation

When you need up-to-date information about the AI SDK:

### If using [email protected] or above

Search the bundled documentation and source code in `node_modules/ai/`:

1. **Documentation**: `grep "your query" node_modules/ai/docs/`
2. **Source code**: `grep "your query" node_modules/ai/src/`

To find specific files:

- `glob "node_modules/ai/docs/**/*.mdx"` for documentation files
- `glob "node_modules/ai/src/**/*.ts"` for source files

Provider packages (`@ai-sdk/openai`, `@ai-sdk/anthropic`, etc.) also include bundled docs in their respective `node_modules/@ai-sdk/<provider>/docs/` directories.

**When in doubt, update to the latest version of the AI SDK.**

### Otherwise

1. Search the docs: `https://ai-sdk.dev/api/search-docs?q=your_query`
2. The response includes matches with links ending in `.md`
3. Fetch those `.md` URLs directly to get plain text content (e.g. `https://ai-sdk.dev/docs/agents/building-agents.md`)

Use these resources for current API details, examples, and usage patterns.

For common errors and troubleshooting, see [Common Errors Reference](references/common-errors.md).

## Provider-Specific Information ([email protected]+)

For questions about specific providers (OpenAI, Anthropic, Google, etc.), search their dedicated packages:

1. **Provider documentation**: `grep "your query" node_modules/@ai-sdk/<provider>/docs/`
2. **Provider source code**: `grep "your query" node_modules/@ai-sdk/<provider>/src/`

To find provider files:

- `glob "node_modules/@ai-sdk/<provider>/docs/**/*.mdx"` for provider documentation
- `glob "node_modules/@ai-sdk/<provider>/src/**/*.ts"` for provider source files

This is especially important for `providerOptions`, which are provider-specific settings passed to model calls. Each provider has unique options documented in their package.

Overview

This skill helps developers answer questions about the AI SDK and build AI-powered features using its functions and provider integrations. It focuses on usage patterns for generateText, streamText, ToolLoopAgent, tools, and provider-specific options. The goal is to accelerate building agents, chatbots, and structured-output workflows with practical guidance.

How this skill works

I inspect the AI SDK documentation and source layout to locate relevant API details and examples. For recent SDK versions ([email protected]+), I direct you to the bundled docs and source in node_modules and explain how to grep or glob for specific files. For other versions I point to the public docs search and direct .md endpoints for authoritative content. I also highlight where provider-specific options live so you can tune model calls.

When to use it

  • You need to implement text generation or streaming responses (generateText, streamText).
  • You are building or debugging an agent or ToolLoopAgent workflow.
  • You must integrate or troubleshoot provider-specific options (OpenAI, Anthropic, Google, etc.).
  • You want examples of tool calling, structured output, or multi-step agent orchestration.
  • You need quick pointers to SDK docs and source in your project for up-to-date behavior.

Best practices

  • Update to the latest ai package when possible to match docs and examples.
  • Search bundled package docs and source for precise, versioned API behavior rather than relying on third-party summaries.
  • Review provider-specific packages for providerOptions and example usage before changing model parameters.
  • Prefer streaming APIs for low-latency user experiences and use structured output tooling for reliable parsing.
  • Write small reproductions when debugging agent behavior to isolate tool calls and state transitions.

Example use cases

  • Implement a chatbot using generateText for responses and streamText for progressive display.
  • Create a ToolLoopAgent that calls external tools and records tool outputs for follow-up reasoning.
  • Tune providerOptions for latency vs. cost trade-offs when switching between OpenAI and Anthropic backends.
  • Build structured JSON output from model responses and validate with the SDK’s parsing utilities.
  • Search the installed node_modules docs to find exact function signatures and example snippets for your SDK version.

FAQ

How do I find provider-specific options for a model call?

Look in the corresponding provider package docs and source (node_modules/@ai-sdk/<provider>/docs and /src) for providerOptions and examples.

What if the docs in my project don’t match online docs?

Prefer the bundled docs and source in your installed version; if needed, update the ai package to align behavior with the latest documentation.