Agent Development (Codex)

Overview

Codex CLI does not auto-discover "agent" files the way Claude plugins do. To recreate agent behavior in Codex, combine:

• Prompt files that define the agent's role and workflow.
• Codex config profiles to set model/sandbox/approval defaults.
• Skills that describe when to use the agent and how to launch it.
• Worker processes (codex-subagent, codex exec, or worker-dispatch) for isolated execution.

This skill standardizes an agent card format (YAML frontmatter + prompt body) and shows how to run it with Codex.

Agent Card Format (Codex Convention)

Store agent prompts in agents/<agent-name>.md. Frontmatter is metadata for humans and validators; Codex does not read it automatically.