skills/openai-agents-sdk/SKILL.md
OpenAI Agents SDK for building multi-agent workflows with tools, handoffs, guardrails, streaming, MCP, sessions, and tracing. MANDATORY TRIGGERS: openai-agents, openai agents sdk, openai-agents-python, openai agents, Runner.run, function_tool, handoff, guardrail, MCPServerStdio, MCPServerStreamableHttp, HostedMCPTool, RunContextWrapper, AgentHooks. Also trigger when user wants to build multi-agent systems with OpenAI models, create agent orchestration with handoffs, add guardrails to LLM applications, integrate MCP servers with agents, implement streaming agent responses, or use OpenAI's official agent framework. When in doubt about whether to use this skill for OpenAI agent tasks, use it.
npx skillsauth add abhisheksharma-17/skills-graph openai-agents-sdkInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Lightweight, powerful framework for building multi-agent workflows with tools, handoffs, guardrails, and tracing.
Source: openai.github.io/openai-agents-python | Package: openai-agents v0.17.x | License: MIT
| Reference | File | Read When |
|-----------|------|-----------|
| Overview & Setup | references/00-overview.md | Getting started, installation, quickstart, architecture |
| Agents | references/01-agents.md | Agent creation, instructions, output types, hooks, cloning |
| Tools | references/02-tools.md | Function tools, hosted tools, tool search, agents as tools |
| Running Agents | references/03-running-agents.md | Runner.run, RunConfig, input management, error handling |
| Handoffs | references/04-handoffs.md | Agent delegation, input filters, callbacks, nested history |
| Guardrails | references/05-guardrails.md | Input/output validation, tripwires, tool guardrails |
| Streaming | references/06-streaming.md | Stream events, real-time output, cancellation, approvals |
| Context | references/07-context.md | RunContextWrapper, ToolContext, dependency injection |
| Multi-Agent | references/08-multi-agent.md | Orchestration patterns, manager vs handoff, visualization |
| Models | references/09-models.md | OpenAI models, non-OpenAI providers, LiteLLM, retries |
| MCP Integration | references/10-mcp.md | MCP servers, hosted MCP, tool filtering, server manager |
| Sessions | references/11-sessions.md | Conversation persistence, SQLite, SQLAlchemy, encrypted |
| Tracing | references/12-tracing.md | Built-in tracing, custom spans, processors, sensitivity |
# Core package
pip install openai-agents
# With voice support
pip install 'openai-agents[voice]'
# With LiteLLM integration
pip install 'openai-agents[litellm]'
# Using uv
uv add openai-agents
# Set API key
export OPENAI_API_KEY=sk-...
development
High-throughput LLM inference and serving engine with PagedAttention, continuous batching, and OpenAI-compatible API. MANDATORY TRIGGERS: vLLM, vllm, LLM serving, LLM inference engine, PagedAttention. Also trigger when the user wants to serve LLMs in production, deploy models with tensor parallelism, use speculative decoding, quantize models for inference, build OpenAI-compatible API servers, or optimize LLM throughput and latency. When in doubt about whether to use this skill for LLM serving tasks, use it.
tools
Type-safe Python agent framework for building production-grade GenAI applications with Pydantic validation, structured outputs, and dependency injection. MANDATORY TRIGGERS: pydantic-ai, pydantic_ai, PydanticAI, pydantic ai agent. Also trigger when the user wants to build type-safe AI agents in Python, create structured LLM outputs with Pydantic models, implement dependency injection for agents, use tools/capabilities with LLMs, or build multi-agent systems with Python type safety. When in doubt about whether to use this skill for Python AI agent tasks, use it.
development
Durable execution platform for building fault-tolerant workflows, long-running processes, and resilient distributed applications. MANDATORY TRIGGERS: temporal, temporal.io, temporalio, durable execution, workflow orchestration engine. Also trigger when the user wants to build fault-tolerant workflows, implement saga patterns, create long-running distributed processes, orchestrate microservices with retries and timeouts, or build durable AI agent pipelines. When in doubt about whether to use this skill for workflow orchestration or durable execution tasks, use it.
tools
AI framework for building RAG pipelines, agents, workflows, and data-augmented LLM applications with 300+ integrations. MANDATORY TRIGGERS: llamaindex, llama-index, llama_index, LlamaIndex, VectorStoreIndex, SimpleDirectoryReader, LlamaHub, LlamaParse. Also trigger when the user wants to build RAG applications with LlamaIndex, create document indexing pipelines, build agentic workflows with tool calling, implement structured data extraction from documents, or connect LLMs to custom data sources. When in doubt about whether to use this skill for RAG, document indexing, or LLM data augmentation tasks, use it.