agents-sdk · openai — Codex skill: build OpenAI Agents SDK apps
Builds, runs, and tests OpenAI Agents SDK apps from Codex. Turns a prompt, repo, or session into a working agent with tools and eval tests.
npx skills add openai/plugins --skill agents-sdk -a codexWhat agents-sdk does
The skill creates Agents SDK apps from a prompt, existing repository, or Codex session history. It reads OpenAI docs before building, writes Python code (or TypeScript on request), adds function tools via @function_tool, and provides isolated execution through SandboxAgent when the agent needs file or shell access. Interaction diagrams are generated directly as PNG files.
Each app gets a structure with agent.py, main.py, and evals/, docs/, skills/ folders. Eval tests check the real agent path, not just contracts: tool calls, handoffs, edge cases. HTTP apps start with uv run python main.py, read the PORT variable, and expose /health for readiness checks. Before running, the skill requires confirmation of OPENAI_API_KEY access through a separate gate — a prompt to verify the key is in the environment.
What it helps with
- build an Agents SDK agent from a prompt or idea
- add eval tests to verify agent behavior
- turn Codex session history into a runnable app
- deploy an agent through Deployment Manager
- isolate shell commands and file operations in a sandbox
Example prompts for the agent
- Build an Agents SDK agent that checks order status via API and returns JSON
- Add eval cases for `agent.py`: verify tool call and API error handling
- Deploy this app locally through Deployment Manager
How to install agents-sdk
1Skills CLI (Vercel)
npx skills add openai/plugins --skill agents-sdk -a codex2Manually: put the files in place
.agents/skills/agents-sdk/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add openai/plugins --skill agents-sdk -a claude-code2Manually: put the files in place
~/.claude/skills/agents-sdk/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/agents-sdk/
Manually: put the files in place
.cursor/skills/agents-sdk/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install openai/plugins agents-sdk2Manually: put the files in place
.github/skills/agents-sdk/SKILL.mdPlatform CLI
gemini skills install https://github.com/openai/plugins --path plugins/openai-developers/skills/agents-sdkManually: put the files in place
.devin/skills/agents-sdk/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
From the same set201
The whole set →Other versions of agents-sdk
Similar
Questions about agents-sdk
How to install agents-sdk in Codex?
Run npx skills add openai/plugins --skill agents-sdk in the terminal. The skill will appear in .agents/skills/agents-sdk/.
What does agents-sdk do?
Creates OpenAI Agents SDK apps: writes agent code, adds tools and sandbox, generates eval tests, and deploys through Deployment Manager. Works with Python and TypeScript.
What does agents-sdk require?
An OPENAI_API_KEY environment variable for API calls. The skill will request confirmation of key access before running the agent. For Python projects, it uses uv and the openai-agents dependency.