openai-agents
OpenAI Agents SDK for JavaScript/TypeScript (text + voice agents). Use for multi-agent workflows, tools, guardrails, or encountering Zod errors, MCP failures, infinite loops, tool call issues.
npx skills add majiayu000/claude-skill-registry --skill openai-agents-secondsky-claude-skills --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# OpenAI Agents SDK Skill Complete skill for building AI applications with OpenAI Agents SDK (JavaScript/TypeScript), covering text agents, realtime voice agents, multi-agent workflows, and production deployment patterns. --- ## Quick Start ### Installation ```bash bun add @openai/agents zod@3 bun add @openai/agents-realtime # For voice agents ``` Set environment variable: ```bash export OPENAI_API_KEY="your-api-key" ``` ### Basic Text Agent ```typescript import { Agent, run, tool } from '@openai/agents'; import { z } from 'zod'; const agent = new Agent({ name: 'Assistant', instructions: 'You are helpful.', tools: [tool({ name: 'get_weather', parameters: z.object({ city: z.string() }), execute: async ({ city }) => `Weather in ${city}: sunny`, })], model: 'gpt-4o-mini', }); const result = await run(agent, 'What is the weather in SF?'); ``` ### Voice Agent & Multi-Agent ```typescript // Voice agent const voiceAgent = new RealtimeAgent({ voice: 'alloy', model: 'gpt-4o-realtime-preview', }); // Browser session const session = new RealtimeSession(voiceAgent, { apiKey: sessionApiKey, // From backend! transport: 'webrtc', }); // Multi-agent handoffs const triageAgent = Agent.create({ hand
- Quick Start
- Installation
- Basic Text Agent
- Voice Agent & Multi-Agent
- Top 3 Critical Errors
- 1. Zod Schema Type Errors
- 2. MCP Tracing Errors
- 3. MaxTurnsExceededError
- When to Load References
- Agent Patterns (references/agent-patterns.md)
- Common Errors (references/common-errors.md)
- Realtime Transports (references/realtime-transports.md)
- Cloudflare Integration (references/cloudflare-integration.md)
- Official Links (references/official-links.md)
bun add @openai/agents zod@3 bun add @openai/agents-realtime # For voice agents export OPENAI_API_KEY="your-api-key"
What does the openai-agents skill do?
OpenAI Agents SDK for JavaScript/TypeScript (text + voice agents). Use for multi-agent workflows, tools, guardrails, or encountering Zod errors, MCP failures, infinite loops, tool call issues.
How do I install it?
Run `npx skills add majiayu000/claude-skill-registry --skill openai-agents-secondsky-claude-skills --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From majiayu000/claude-skill-registry, a repository with 534 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.