skill-codex

A Claude Code skill that delegates tasks to OpenAI's Codex CLI for code analysis, review and edits

Skill

High risk

We rate an entry high when the tool writes to external systems, handles money, production databases or secrets, or runs arbitrary commands. The CLI installs it only with your consent.

Why this level

  • Runs Codex CLI, which can change files and execute commands
  • In full-access mode Codex reaches the network
All reasons and checks
Needs a VPN

skills-directory/skill-codex

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add skills/skill-codex

Detects the agents on your machine, checks the risk and pins the version.

Other ways to install

Run in a terminal in the project folder

npx skills add skills-directory/skill-codex --skill codex -a claude-code -y

The skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.

Without third-party tools, from commit 0cf3e4b
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/skills-directory/skill-codex.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /plugins/skill-codex/skills/codex/
git -C "$tmp" checkout 0cf3e4b6e801cae209fc27a50440b453b44af910
mkdir -p .claude/skills
cp -R "$tmp/plugins/skill-codex/skills/codex" .claude/skills/codex

Commands for macOS and Linux, on Windows run them in Git Bash.

Run in a terminal in the project folder

npx skills add skills-directory/skill-codex --skill codex -a cursor -y

The skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.

Without third-party tools, from commit 0cf3e4b
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/skills-directory/skill-codex.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /plugins/skill-codex/skills/codex/
git -C "$tmp" checkout 0cf3e4b6e801cae209fc27a50440b453b44af910
mkdir -p .agents/skills
cp -R "$tmp/plugins/skill-codex/skills/codex" .agents/skills/codex

Commands for macOS and Linux, on Windows run them in Git Bash.

Run in a terminal in the project folder

npx skills add skills-directory/skill-codex --skill codex -a github-copilot -y

The skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.

Without third-party tools, from commit 0cf3e4b
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/skills-directory/skill-codex.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /plugins/skill-codex/skills/codex/
git -C "$tmp" checkout 0cf3e4b6e801cae209fc27a50440b453b44af910
mkdir -p .github/skills
cp -R "$tmp/plugins/skill-codex/skills/codex" .github/skills/codex

Commands for macOS and Linux, on Windows run them in Git Bash.

Run in a terminal in the project folder

npx skills add skills-directory/skill-codex --skill codex -a codex -y

The skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.

Without third-party tools, from commit 0cf3e4b
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/skills-directory/skill-codex.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /plugins/skill-codex/skills/codex/
git -C "$tmp" checkout 0cf3e4b6e801cae209fc27a50440b453b44af910
mkdir -p .agents/skills
cp -R "$tmp/plugins/skill-codex/skills/codex" .agents/skills/codex

Commands for macOS and Linux, on Windows run them in Git Bash.

Run in a terminal in the project folder

npx skills add skills-directory/skill-codex --skill codex -a gemini-cli -y

The skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.

Without third-party tools, from commit 0cf3e4b
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/skills-directory/skill-codex.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /plugins/skill-codex/skills/codex/
git -C "$tmp" checkout 0cf3e4b6e801cae209fc27a50440b453b44af910
mkdir -p .agents/skills
cp -R "$tmp/plugins/skill-codex/skills/codex" .agents/skills/codex

Commands for macOS and Linux, on Windows run them in Git Bash.

Run in a terminal in the project folder

tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/skills-directory/skill-codex.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /plugins/skill-codex/skills/codex/
git -C "$tmp" checkout 0cf3e4b6e801cae209fc27a50440b453b44af910
mkdir -p .devin/skills
cp -R "$tmp/plugins/skill-codex/skills/codex" .devin/skills/codex

Commands for macOS and Linux, on Windows run them in Git Bash.

Formerly Windsurf.

Run in a terminal in the project folder

npx skills add skills-directory/skill-codex --skill codex -a cline -y

The skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.

Without third-party tools, from commit 0cf3e4b
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/skills-directory/skill-codex.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /plugins/skill-codex/skills/codex/
git -C "$tmp" checkout 0cf3e4b6e801cae209fc27a50440b453b44af910
mkdir -p .cline/skills
cp -R "$tmp/plugins/skill-codex/skills/codex" .cline/skills/codex

Commands for macOS and Linux, on Windows run them in Git Bash.

Run in a terminal in the project folder

npx skills add skills-directory/skill-codex --skill codex -a roo -y

The skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.

Without third-party tools, from commit 0cf3e4b
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/skills-directory/skill-codex.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /plugins/skill-codex/skills/codex/
git -C "$tmp" checkout 0cf3e4b6e801cae209fc27a50440b453b44af910
mkdir -p .roo/skills
cp -R "$tmp/plugins/skill-codex/skills/codex" .roo/skills/codex

Commands for macOS and Linux, on Windows run them in Git Bash.

A fork of Roo Code, same .roo folders.

Run in a terminal in the project folder

npx skills add skills-directory/skill-codex --skill codex -a opencode -y

The skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.

Without third-party tools, from commit 0cf3e4b
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/skills-directory/skill-codex.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /plugins/skill-codex/skills/codex/
git -C "$tmp" checkout 0cf3e4b6e801cae209fc27a50440b453b44af910
mkdir -p .agents/skills
cp -R "$tmp/plugins/skill-codex/skills/codex" .agents/skills/codex

Commands for macOS and Linux, on Windows run them in Git Bash.

Run in a terminal in the project folder

tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/skills-directory/skill-codex.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /plugins/skill-codex/skills/codex/
git -C "$tmp" checkout 0cf3e4b6e801cae209fc27a50440b453b44af910
mkdir -p .agents/skills
cp -R "$tmp/plugins/skill-codex/skills/codex" .agents/skills/codex

Commands for macOS and Linux, on Windows run them in Git Bash.

Run in a terminal in the project folder

tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/skills-directory/skill-codex.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /plugins/skill-codex/skills/codex/
git -C "$tmp" checkout 0cf3e4b6e801cae209fc27a50440b453b44af910
mkdir -p .agents/skills
cp -R "$tmp/plugins/skill-codex/skills/codex" .agents/skills/codex

Commands for macOS and Linux, on Windows run them in Git Bash.

You will need: Node.js

Checked against the repository on Sep 25, 2026, commit 0cf3e4b.

Text for your agent

Install the plugin: /plugin marketplace add skills-directory/skill-codex, then /plugin install skill-codex@skill-codex. Codex CLI must be installed and available on PATH.

Other ways from the author
/plugin marketplace add skills-directory/skill-codex
/plugin install skill-codex@skill-codex

Codex CLI must be installed and available on PATH.

This is third-party code. Review the repository files before installing.

What it does

The skill teaches Claude Code to call OpenAI's Codex CLI. On request the agent assembles a codex exec invocation: it picks the model and reasoning effort, sets the sandbox mode from read-only to full access, runs the command and summarizes the result. It supports continuing a previous session with resume and by default hides service output so it does not bloat the context. It installs as a Claude Code plugin or by copying the skill folder into the skills directory.

Who it is for. For developers in Claude Code who want to bring Codex CLI into tasks as a second model.

Good fit when

  • You need Codex to analyze a repository or propose edits
  • You want a review or refactor from a second model
  • You need to resume a previous Codex session on the code

Not a fit when

  • Codex CLI is not installed or there is no access to OpenAI models
  • One agent is enough without a second model

Example request

Use codex to analyze this repository and suggest improvements

Limitations

You need Codex CLI installed with valid access to OpenAI models. OpenAI models are not reachable from Russia without a VPN. In write and full-access modes Codex changes files and reaches the network, so run it deliberately.

How to disable. Remove the plugin with /plugin, or delete the codex folder from the ~/.claude/skills/ directory.

Security check

  • Runs Codex CLI, which can change files and execute commands
  • In full-access mode Codex reaches the network

README in short

The README presents the repository as a Claude Code plugin with a marketplace and explains how the skill calls Codex CLI via codex exec and session resume. Before use you install Codex CLI and check it with codex --version. Installation is either as a plugin through the marketplace or by manually copying the skill folder. The skill lets you choose the model, reasoning effort and sandbox mode, hides service output by default, and advises treating Codex answers critically.

SKILL.md

---
name: codex
description: Use when the user asks to run Codex CLI (codex exec, codex resume) or references OpenAI Codex for code analysis, refactoring, or automated editing
---

# Codex Skill Guide

## Running a Task
1. For a new session (resumes inherit the prior model/effort), ask the user which model AND which reasoning effort to use, in a single prompt with two questions. When the user expresses no preference, use the documented defaults.
2. Select the sandbox mode required for the task; default to --sandbox read-only unless edits or network access are necessary.
3. Assemble the command with the appropriate options: model, reasoning effort, sandbox, and the prompt as the final positional argument.
4. Always use --skip-git-repo-check.
5. When continuing a previous session, resume via stdin without configuration flags unless the user asks for them.

FAQ

What is needed besides the skill?

Codex CLI on PATH with configured access to OpenAI models.

Can Codex change code?

Yes, in write or full-access mode. By default it uses read-only mode.

Editors’ pick

A skills library that gives coding agents a development process: brainstorming, planning, TDD, subagents and code review

PluginMedium riskNo VPN needed292.5KRepository stars
Editors’ pick

Small composable skills for engineering with agents: plan grilling, TDD, bug diagnosis, code review and architecture

SkillLow risk271.4KRepository stars
Editors’ pick

GitHub toolkit for spec-driven development: the specify CLI adds agent commands and skills to a project, from principles to implementation

CLIMedium riskNo VPN needed139.3KRepository stars

Reference MCP servers

Model Context Protocol servers

Official

Official reference MCP servers: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time and Everything

MCP serverMedium risk90.6KRepository stars
Foxx AIskill-codex

I am Foxx AI and I have already vetted this tool. Ask about install, setup or anything else, and I will keep it simple.