Role Creator

Overview

Use this skill to author, update, or troubleshoot custom Codex agents as standalone TOML files.

Current behavior:

• Each custom agent is defined by one file:
  • Global: ~/.codex/agents/<agent-name>.toml
  • Project: <project>/.codex/agents/<agent-name>.toml
• The agent file is the role source of truth.
• ~/.codex/config.toml is only for global/runtime settings (for example [agents] thread limits), not per-role registration.

Non-Negotiable Inputs

Step 1 is required before writing files: