Codex Code Review Skill

Codex Code Review

Hand off code review tasks to OpenAI's Codex CLI for an independent AI perspective on code changes.

How This Skill Works

When invoked, this skill launches the Codex CLI's review command in the terminal to analyze code changes. Codex provides a fresh perspective using OpenAI's models, which can catch different issues than Claude might.

When to Use This Skill

Getting a second opinion on code changes before committing
Reviewing uncommitted work (staged, unstaged, or untracked files)
Reviewing a pull request against a base branch
Analyzing a specific commit for potential issues
Cross-validating Claude's own code suggestions

Review Modes

1. Uncommitted Changes (Default)

Review all local changes not yet committed:

codex review --uncommitted

2. PR Review (Against Base Branch)

Review changes between current branch and a base branch:

codex review --base main

3. Specific Commit

Review changes introduced by a single commit:

codex review --commit <SHA>

4. Custom Instructions

Add specific review focus areas:

codex review --uncommitted "Focus on security vulnerabilities and error handling"

Execution Instructions

IMPORTANT: When this skill is invoked, Claude MUST execute the appropriate codex review command using the Bash tool. Do not just describe what to do — actually run the command.

Argument Handling

| User Says | Command to Run | |-----------|----------------| | /codex-review (no args) | codex review --uncommitted | | /codex-review uncommitted | codex review --uncommitted | | /codex-review PR or /codex-review main | codex review --base main | | /codex-review PR #123 | First gh pr checkout 123, then codex review --base main | | /codex-review <branch> | codex review --base <branch> | | /codex-review <sha> | codex review --commit <sha> |

Execution Steps

Determine review mode from arguments (default: uncommitted)
Run the codex review command using Bash tool
Present the results to the user with any notable findings highlighted
Offer follow-up actions (apply suggestions, create issues, etc.)

Command Reference

# Full options
codex review [OPTIONS] [PROMPT]

Options:
  --uncommitted          Review staged, unstaged, and untracked changes
  --base <BRANCH>        Review changes against the given base branch
  --commit <SHA>         Review the changes introduced by a commit
  --title <TITLE>        Optional commit title to display in review summary
  -c, --config <k=v>     Override config (e.g., -c model="o3")
  -h, --help             Print help

Example Workflows

Quick Local Review

# Review everything you've changed locally
codex review --uncommitted

Pre-PR Review

# Review your feature branch against main before opening PR
codex review --base main "Check for breaking changes and missing tests"

Focused Security Review

# Security-focused review of uncommitted changes
codex review --uncommitted "Focus on: SQL injection, XSS, auth bypass, secrets exposure"

Integration Notes

Codex CLI must be installed and authenticated (codex login)
Reviews run non-interactively and output results to terminal
Use codex apply after review to apply any suggested diffs
Combine with Claude's own review for comprehensive coverage

Agent Skills: Codex Code Review

Install this agent skill to your local

Skill Files