Codex Orchestration

How OpenAI Codex CLI discovers skills, fires hooks, and loads instructions. Use this skill instead of web-searching the docs each time.

Source of truth: developers.openai.com/codex/{skills,hooks,config-advanced,config-reference,guides/agents-md}. Verify against live docs if behavior seems off - orchestration features evolve.

When to Activate

• Install a skill and need the correct target directory
• Wire a Codex hook and need the event name, matcher, or payload shape
• Debug why an implicit skill isn't triggering on a matching prompt
• Author or review agents/openai.yaml for a skill
• Explain to a teammate why format-on-edit hooks don't work in Codex
• Migrate hook or skill conventions from Claude Code to Codex
• Add a notify program for turn-complete events
• Write or update this repo's README/hooks documentation

Discovery: Skills