codex-review

Execute non-interactive Codex CLI code reviews for branch, diff, or plan analysis.

Updated Feb 10, 2026
One-click install
npx skills add https://github.com/wordshepherd/colophony --skill codex-review-wordshepherd
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: codex-review
Source: https://github.com/wordshepherd/colophony/tree/main/.claude/skills/codex-review
Command: npx skills add https://github.com/wordshepherd/colophony --skill codex-review-wordshepherd

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill automates the process of running code reviews using the Codex CLI, providing structured feedback on code quality and adherence to project standards without manual intervention.

Core Features & Use Cases

  • Non-interactive Code Review: Executes codex review with various modes (branch, diff, plan).
  • Prerequisite Verification: Checks for necessary tools like nvm, node, and codex.
  • Plan Drift Detection: Compares code changes against a project plan file for deviations.
  • Use Case: Before merging a pull request, run /codex-review branch to get an automated code review and ensure the changes align with the project's established rules and the approved plan.

Quick Start

Run a code review of all changes on the current branch against origin/main.

Frequently Asked Questions about codex-review

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate code reviews using the Codex CLI?

You can automate code reviews by executing non-interactive Codex CLI commands for branch, diff, or plan-based analysis to receive structured feedback on code quality and project standard adherence.

What is plan drift detection in automated code review?

Plan drift detection compares code changes against a project plan file during a code review to identify deviations from the approved plan and established project rules.

Do I need Node.js and nvm to run Codex CLI code reviews?

Yes, running Codex CLI code reviews requires Node.js, nvm, and the Codex CLI because the system validates these prerequisites before executing the non-interactive review process.

Can I review code changes against origin/main before a pull request merge?

Yes, you can review all changes on your current branch against origin/main before merging a pull request to ensure changes align with project rules and approved plans.

What's the best way to check for project plan deviations in a CI/CD pipeline?

The best way is using a non-interactive code review tool that compares branch or diff changes against a project plan file to detect plan drift within your CI/CD automation.

Why does my automated code review fail to start?

Your code review fails to start if prerequisite tools like nvm, node, and the Codex CLI are not installed or properly configured, as the system validates these dependencies before operation.