Individual skill

agents

Build agent apps with the Agents API or Agents SDK. Use when adding tools, sessions, sandboxes, handoffs, guardrails, evals, or deployment.

OpenAI/Codex/plugins/openai-developers/skills/agents/SKILL.md

Read pinned source

Source commit a2d33761e49b98f6ec1b48f12143264eb9b4ff4f

What was checked

Matches the observed repository HEAD: Yes
Scanner rules are current: Yes
Repository scan complete: No
Skill scan complete: No
Observed behavior: Network or broad shell
Last checked: Nov 10, 2026

These are observations at the recorded commit, not a guarantee of safety. Review the source before running it.

Install this skill

Choose an agent in your Stack or copy a command below. Commands fetch the pinned commit and copy only this skill directory. Existing destinations are refused. Copying a command does not install anything.

An install command is unavailable: current rules, complete repository and skill scans, an eligible behavior level and a permitted license are required.

Repository context

Repository stars (not skill ratings): 71,166
Repository last updated: Nov 10, 2026
License: CC0-1.0

Observed agent integration: No specific integration evidence. Standard SKILL.md installation does not imply verified compatibility.

ai Repository topic
anthropic Repository topic
chatbot Repository topic
chatgpt Repository topic
claude Repository topic
claude-code Repository topic
codex Repository topic
gemini Repository topic
generative-ai Repository topic
google Repository topic
devops Derived category

Files and excerpt

File metadata and permitted, redacted excerpts come from the recorded scan. Source links are pinned to that commit.

Browse files

SKILL.mdcore · 6,830 bytes
SKILL.mdcore · 6,830 bytes
references/agents-sdk.mddoc · 4,630 bytes
references/app-template.mddoc · 2,018 bytes
references/evals.mddoc · 2,371 bytes
references/sandbox-providers.mddoc · 3,453 bytes

Read excerpt


# Agents

## Entry points and runtime

Answer explanations without setup or edits. For existing apps, keep their conventions.

- Use the **Agents API with `environment={"type": "openai_hosted"}` by default**. OpenAI runs the agent, manages its sandbox, and stores session state. A background task or application-hosted function does not require the Agents SDK.
- Use the **Agents SDK** when requested, already used by the app, or needed for a caller-owned agent loop, SDK handoffs, or guardrails. Follow [the SDK workflow](references/agents-sdk.md) after credential setup.
- Agents API sandboxes run `codex exec-server`. Neither path provides a caller-hosted `codex app-server`.

For agent-powered websites, also follow frontend guidance. Other websites and simple AI apps do not need this skill.

## Agents API lifecycle