SkillAgentSearch skills...

develop-ai-functions-example

Develop examples for AI SDK functions

Install / Use

npx skills add vercel/ai --skill develop-ai-functions-example

Installs into whichever agent you are using.

About this skill
📄

SKILL.md

Installable skill definition

Quality Score

91/100

Supported Platforms

Universal

Our assessment of develop-ai-functions-example

develop-ai-functions-example scores 91/100 on our quality scale, 124th of 319 Customer Support skills we index (top 39%).

Its SKILL.md is 8.0 KB long, well organised into 15 sections with 8 code examples: a thorough specification that gives an agent plenty to work with.

With 26,924 GitHub stars, it is one of the more widely adopted skills in the catalogue.

Substance
29/30
Structure
20/20
Description
8/15
Adoption
19/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated about 2 months ago, so develop-ai-functions-example is actively maintained.
  • Our last check on 2026-10-28 found the source still online.
  • No license is declared. By default that means all rights are reserved: you can read it, but reusing or redistributing it is not clearly permitted. Ask the author before building on it commercially.
  • Its trust signals score 88/100, with 1 caution from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

Safety scan

No issues found

Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.

AI review by kimi-k2.7-code on 2026-09-27. Automated pattern scan on 2026-09-27. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.

develop-ai-functions-example compared with similar skills

All 4 of these similar skills score higher than develop-ai-functions-example; compare them before choosing.

SkillScoreStarsUpdatedFormat
develop-ai-functions-example (this skill)by vercel9126.9k53d agoSKILL.md
x402by browser-use100121.0k3d agoSKILL.md
algorithmic-artby anthropics100177.9k55d agoSKILL.md
pptxby anthropics100177.9k55d agoSKILL.md
designby nextlevelbuilder100149.0k6d agoSKILL.md

Frequently asked questions

How do I install develop-ai-functions-example?
Run npx skills add vercel/ai --skill develop-ai-functions-example. The install tabs above show the steps for each supported agent.
Which AI agents does develop-ai-functions-example work with?
It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
Is develop-ai-functions-example safe to use?
Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It declares no license and scores 88/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is develop-ai-functions-example still maintained?
The repository was last updated about 2 months ago, so develop-ai-functions-example is actively maintained.

name: develop-ai-functions-example description: Develop examples for AI SDK functions. Use when creating, running, or modifying examples under examples/ai-functions/src to validate provider support, demonstrate features, or create test fixtures. metadata: internal: true

AI Functions Examples

The examples/ai-functions/ directory contains scripts for validating, testing, and iterating on AI SDK functions across providers.

Example Categories

Examples are organized by AI SDK function in examples/ai-functions/src/:

| Directory | Purpose | | ------------------ | ---------------------------------------------------- | | generate-text/ | Non-streaming text generation with generateText() | | stream-text/ | Streaming text generation with streamText() | | generate-object/ | Structured output generation with generateObject() | | stream-object/ | Streaming structured output with streamObject() | | agent/ | ToolLoopAgent examples for agentic workflows | | embed/ | Single embedding generation with embed() | | embed-many/ | Batch embedding generation with embedMany() | | generate-image/ | Image generation with generateImage() | | generate-speech/ | Text-to-speech with generateSpeech() | | transcribe/ | Audio transcription with transcribe() | | rerank/ | Document reranking with rerank() | | middleware/ | Custom middleware implementations | | registry/ | Provider registry setup and usage | | telemetry/ | OpenTelemetry integration | | complex/ | Multi-component examples (agents, routers) | | lib/ | Shared utilities (not examples) | | tools/ | Reusable tool definitions |

File Naming Convention

Group examples by function and provider. Name the entry example basic.ts and use descriptive kebab-case.ts names for additional examples:

| Pattern | Example | Description | | --------------------------------------------------- | ------------------------------------------------------ | -------------------------- | | <function>/<provider>/basic.ts | generate-text/openai/basic.ts | Basic provider usage | | <function>/<provider>/<feature>.ts | stream-text/openai/tool-call.ts | Specific feature | | <function>/<provider>/<sub-provider>.ts | stream-text/amazon-bedrock/anthropic.ts | Provider with sub-provider | | <function>/<provider>/<sub-provider>-<feature>.ts | stream-text/google/vertex-anthropic-cache-control.ts | Sub-provider with feature |

Do not create flat provider files such as generate-text/openai.ts.

Example Structure

All examples use the run() wrapper from lib/run.ts which:

  • Loads environment variables from .env
  • Provides error handling with detailed API error logging

Basic Template

import { providerName } from '@ai-sdk/provider-name';
import { generateText } from 'ai';
import { run } from '../../lib/run';

run(async () => {
  const result = await generateText({
    model: providerName('model-id'),
    prompt: 'Your prompt here.',
  });

  console.log(result.text);
  console.log('Token usage:', result.usage);
  console.log('Finish reason:', result.finishReason);
});

Streaming Template

import { providerName } from '@ai-sdk/provider-name';
import { streamText } from 'ai';
import { printFullStream } from '../../lib/print-full-stream';
import { run } from '../../lib/run';

run(async () => {
  const result = streamText({
    model: providerName('model-id'),
    prompt: 'Your prompt here.',
  });

  await printFullStream({ result });
});

Tool Calling Template

import { providerName } from '@ai-sdk/provider-name';
import { generateText, tool } from 'ai';
import { z } from 'zod';
import { run } from '../../lib/run';

run(async () => {
  const result = await generateText({
    model: providerName('model-id'),
    tools: {
      myTool: tool({
        description: 'Tool description',
        inputSchema: z.object({
          param: z.string().describe('Parameter description'),
        }),
        execute: async ({ param }) => {
          return { result: `Processed: ${param}` };
        },
      }),
    },
    prompt: 'Use the tool to...',
  });

  console.log(JSON.stringify(result, null, 2));
});

Structured Output Template

import { providerName } from '@ai-sdk/provider-name';
import { generateObject } from 'ai';
import { z } from 'zod';
import { run } from '../../lib/run';

run(async () => {
  const result = await generateObject({
    model: providerName('model-id'),
    schema: z.object({
      name: z.string(),
      items: z.array(z.string()),
    }),
    prompt: 'Generate a...',
  });

  console.log(JSON.stringify(result.object, null, 2));
  console.log('Token usage:', result.usage);
});

Running Examples

From the examples/ai-functions directory:

pnpm tsx src/generate-text/openai/basic.ts
pnpm tsx src/stream-text/openai/tool-call.ts
pnpm tsx src/agent/openai/generate.ts

When to Write Examples

Write examples when:

  1. Adding a new provider: Create basic examples for each supported API (generateText, streamText, generateObject, etc.)

  2. Implementing a new feature: Demonstrate the feature with at least one provider example

  3. Reproducing a bug: Create an example that shows the issue for debugging

  4. Adding provider-specific options: Show how to use providerOptions for provider-specific settings

  5. Creating test fixtures: Use examples to generate API response fixtures (see capture-api-response-test-fixture skill)

Utility Helpers

The lib/ directory contains shared utilities:

| File | Purpose | | ---------------------- | -------------------------------------------------------- | | run.ts | Error-handling wrapper with .env loading | | print.ts | Clean object printing (removes undefined values) | | print-full-stream.ts | Colored streaming output for tool calls, reasoning, text | | save-raw-chunks.ts | Save streaming chunks for test fixtures | | present-image.ts | Display images in terminal | | save-audio.ts | Save audio files to disk |

Using print utilities

import { print } from '../lib/print';

// Pretty print objects without undefined values
print('Result:', result);
print('Usage:', result.usage, { depth: 2 });

Using printFullStream

import { printFullStream } from '../lib/print-full-stream';

const result = streamText({ ... });
await printFullStream({ result }); // Colored output for text, tool calls, reasoning

Reusable Tools

The tools/ directory contains reusable tool definitions:

import { weatherTool } from '../tools/weather-tool';

const result = await generateText({
  model: openai('gpt-4o'),
  tools: { weather: weatherTool },
  prompt: 'What is the weather in San Francisco?',
});

Best Practices

  1. Keep examples focused: Each example should demonstrate one feature or use case

  2. Use descriptive prompts: Make it clear what the example is testing

  3. Handle errors gracefully: The run() wrapper handles this automatically

  4. Use realistic model IDs: Use actual model IDs that work with the provider

  5. Add comments for complex logic: Explain non-obvious code patterns

  6. Reuse tools when appropriate: Use weatherTool or create new reusable tools in tools/

Related Skills

View on GitHub
GitHub Stars26.9k
CategoryCustomer
Updated1mo ago
Forks5.2k

Languages

TypeScript

Trust signals

88/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

1 medium
develop-ai-functions-example — Universal Skill: Install & Safety Check | SkillAgent