codex-review
npx machina-cli add skill ncklrs/startup-os-skills/codex-review --openclawCodex 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 applyafter review to apply any suggested diffs - Combine with Claude's own review for comprehensive coverage
Source
git clone https://github.com/ncklrs/startup-os-skills/blob/main/skills/codex-review/SKILL.mdView on GitHub Overview
Codex Code Review hands off code review tasks to OpenAI Codex CLI for an independent AI perspective on code changes. It helps catch issues that may differ from other models and offers a second opinion on your code reviews.
How This Skill Works
When invoked, the skill launches the Codex CLI's review command in the terminal to analyze code changes. Codex provides a fresh AI perspective on the changes, potentially catching issues that differ from other reviews. The agent presents the results in the terminal and suggests follow-up actions.
When to Use It
- 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
Quick Start
- Step 1: Determine review mode from arguments (default: uncommitted)
- Step 2: Run the codex review command using Bash tool
- Step 3: Present the results to the user and offer follow-up actions
Best Practices
- Ensure Codex CLI is installed and authenticated (codex login) before running reviews
- Choose the right mode for scope: --uncommitted, --base, or --commit
- Provide focused prompts (e.g., security vulnerabilities, error handling) via the review command
- Run reviews non-interactively and read the terminal output carefully
- Apply suggested diffs with codex apply and cross-check results with Claude's review
Example Use Cases
- Quick Local Review: codex review --uncommitted
- Pre-PR Review: codex review --base main with a focus prompt like 'check for breaking changes and missing tests'
- Security-Focused Review: codex review --uncommitted 'Focus on security vulnerabilities and error handling'
- PR Review Workflow: gh pr checkout 123, then codex review --base main
- Specific Commit Analysis: codex review --commit <SHA>
