How do I install the Codex skill?

Run npx skillmds@latest add diegosouzapw/codex-2 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Codex safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Codex?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Codex free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

diegosouzapw (@diegosouzapw) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Codex by diegosouzapw — Agent Skill

Name: Codex
Rating: 4.5 (4 reviews)
Author: diegosouzapw

Codex

Review code changes, implementation plans, or specific files using OpenAI Codex CLI. Triggers on "review", "check", "validate", "codex". Perfect for maker-checker workflows where you want a second AI agent to review Claude's work before committing. Requires the Codex CLI to be installed (brew install codex-cli or from https://codex.storage.googleapis.com).

diegosouzapw Updated Sep 9, 2026 54 repo stars

File contents

Codex Code Review Skill

Version: 1.1.0 Author: Community-contributed Requires: Codex CLI installed and configured

Overview

Use the Codex CLI to perform independent code reviews on changes made during your Claude Code session. This enables a "proposer-checker-maker-checker" workflow where Claude Code proposes/implements changes and Codex provides an independent review.

Why use this skill instead of the MCP? The mcp__multi-reasoning__codex_review tool has hard timeout limitations that fail on large codebases. Running via Bash allows:

No timeout constraints (configurable up to 10 min per call)
Background execution with run_in_background: true for very large reviews
Progress checking via TaskOutput

Prerequisites

Install the Codex CLI:

brew install codex-cli
# OR download from https://codex.storage.googleapis.com

Configure your OpenAI API key:

codex login

Use the Codex CLI to review recent changes, implementation plans, or specific files.

For Large Codebases

When reviewing large changes (50+ files, major refactors), run in background mode:

# Use run_in_background: true in the Bash tool
codex review "Comprehensive review of all changes since v2.0"

Then check progress with TaskOutput tool using the returned task_id.

Review Recent Git Changes

# Review uncommitted changes
codex review "Review the uncommitted changes in this repo"

# Review specific commit
codex review "Review the changes in commit <hash>"

# Review changes between branches
codex review "Review the diff between main and current branch"

Review Specific Files

# Review a specific file
codex review "Review the code in <file_path>"

# Review multiple files
codex review "Review the implementation in <file1> and <file2>"

Review Implementation Plan

# Review a plan before implementation
codex review "Review this implementation plan: <plan_content>"

Usage Pattern

Identify what needs review (recent changes, specific files, or a plan)
Run codex review with appropriate prompt
Present the review results to the user

The codex review command runs non-interactively and returns feedback that can be incorporated into the Claude Code session.

Workflow Example

User: I just implemented user authentication
Claude: [implements auth.ts, auth-middleware.ts, etc.]
User: /codex
Claude: [runs: codex review --uncommitted]
Claude: Codex found 2 issues:
  1. Missing error handling in auth.ts:45
  2. Password hash strength could be improved
User: Fix those issues
Claude: [fixes issues]
User: /codex
Claude: [runs review again]
Claude: Codex approves! No issues found.

Notes

Works best in git repositories
Review results are shown inline in the Claude Code session
Combines well with Claude's implementation capabilities for a robust development workflow

---name: codex-2description: Review code changes, implementation plans, or specific files using OpenAI Codex CLI. Triggers on "review", "check", "validate", "codex". Perfect for maker-checker workflows where you want a second AI agent to review Claude's work before committing. Requires the Codex CLI to be installed (brew install codex-cli or from https://codex.storage.googleapis.com).--- # Codex Code Review Skill **Version:** 1.1.0 **Author:** Community-contributed **Requires:** [Codex CLI](https://codex.storage.googleapis.com) installed and configured ## Overview Use the Codex CLI to perform independent code reviews on changes made during your Claude Code session. This enables a "proposer-checker-maker-checker" workflow where Claude Code proposes/implements changes and Codex provides an independent review. **Why use this skill instead of the MCP?** The `mcp__multi-reasoning__codex_review` tool has hard timeout limitations that fail on large codebases. Running via Bash allows: - No timeout constraints (configurable up to 10 min per call) - Background execution with `run_in_background: true` for very large reviews - Progress checking via `TaskOutput` ## Prerequisites Install the Codex CLI: ```bash brew install codex-cli # OR download from https://codex.storage.googleapis.com ``` Configure your OpenAI API key: ```bash codex login ``` ## Use the Codex CLI to review recent changes, implementation plans, or specific files. ## For Large Codebases When reviewing large changes (50+ files, major refactors), run in background mode: ```bash # Use run_in_background: true in the Bash tool codex review "Comprehensive review of all changes since v2.0" ``` Then check progress with `TaskOutput` tool using the returned task_id. ## Review Recent Git Changes ```bash # Review uncommitted changes codex review "Review the uncommitted changes in this repo" # Review specific commit codex review "Review the changes in commit <hash>" # Review changes between branches codex review "Review the diff between main and current branch" ``` ## Review Specific Files ```bash # Review a specific file codex review "Review the code in <file_path>" # Review multiple files codex review "Review the implementation in <file1> and <file2>" ``` ## Review Implementation Plan ```bash # Review a plan before implementation codex review "Review this implementation plan: <plan_content>" ``` ## Usage Pattern 1. Identify what needs review (recent changes, specific files, or a plan) 2. Run `codex review` with appropriate prompt 3. Present the review results to the user The `codex review` command runs non-interactively and returns feedback that can be incorporated into the Claude Code session. ## Workflow Example ``` User: I just implemented user authentication Claude: [implements auth.ts, auth-middleware.ts, etc.] User: /codex Claude: [runs: codex review --uncommitted] Claude: Codex found 2 issues: 1. Missing error handling in auth.ts:45 2. Password hash strength could be improved User: Fix those issues Claude: [fixes issues] User: /codex Claude: [runs review again] Claude: Codex approves! No issues found. ``` ## Notes - Works best in git repositories - Review results are shown inline in the Claude Code session - Combines well with Claude's implementation capabilities for a robust development workflow

Frequently asked questions