Leave a star ⭐ if you like it 😘

Enable Claude Code to invoke the Codex CLI (codex exec and session resumes) for automated code analysis, refactoring, and editing workflows.

• codex CLI installed and available on PATH.
• Codex configured with valid credentials and settings.
• Confirm the installation by running codex --version; resolve any errors before using the skill.

This repository is structured as a Claude Code Plugin with a marketplace. You can install it as a plugin (recommended) or extract it as a standalone skill.

Install via Claude Code's plugin system for automatic updates:

/plugin marketplace add skills-directory/skill-codex
/plugin install skill-codex@skill-codex

Extract the skill folder manually:

git clone --depth 1 [email protected]:skills-directory/skill-codex.git /tmp/skills-temp && \
mkdir -p ~/.claude/skills && \
cp -r /tmp/skills-temp/plugins/skill-codex/skills/codex ~/.claude/skills/codex && \
rm -rf /tmp/skills-temp

By default, this skill suppresses thinking tokens (stderr output) using 2>/dev/null to avoid bloating Claude Code's context window. If you want to see the thinking tokens for debugging or insight into Codex's reasoning process, explicitly ask Claude to show them.

User prompt:

Use codex to analyze this repository and suggest improvements for my claude code skill.

Claude Code response: Claude will activate the Codex skill and:

1. Ask which model to use (gpt-5.3-codex-spark, gpt-5.3-codex, or gpt-5.2) unless already specified in your prompt.
2. Ask which reasoning effort level (low, medium, or high) unless already specified in your prompt.
3. Select appropriate sandbox mode (defaults to read-only for analysis)
4. Run a command like:

codex exec -m gpt-5.3-codex-spark \
  --config model_reasoning_effort="high" \
  --sandbox read-only \
  --full-auto \
  --skip-git-repo-check \
  "Analyze this Claude Code skill repository comprehensively..." 2>/dev/null

Result: Claude will summarize the Codex analysis output, highlighting key suggestions and asking if you'd like to continue with follow-up actions.

See plugins/skill-codex/skills/codex/SKILL.md for complete operational instructions, CLI options, and workflow guidance.

MIT License - see LICENSE for details.