Agent Creator

Use this skill when the user wants a new reusable agent added to this repository, not just a one-off spawned subagent for the current turn.

Goal

Create repo-local agent definitions under .codex/agents that match the patterns already used in this codebase.

Local conventions

• Agent files live at .codex/agents/<slug>.toml.
• Keep filenames lowercase and hyphen-safe. Use a user-facing name inside the file.
• Required fields: name, description, model, model_reasoning_effort, sandbox_mode, and developer_instructions.
• Add nickname_candidates when the role is collaborative or likely to be spawned often.
• Use [[skills.config]] only when the agent has a repeatable workflow that should load a repo-local skill automatically.
• Add [mcp_servers.*] blocks only when the role truly depends on an MCP server.

Recommended defaults