codex-review

Automate code, plan, and document reviews via Codex CLI into CODEX_REVIEW.md.

Updated Apr 18, 2026
One-click install
npx skills add https://github.com/theo-learner/codex-review-skills --skill codex-review-theo-learner
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: codex-review
Source: https://github.com/theo-learner/codex-review-skills/tree/main/skills/codex-review
Command: npx skills add https://github.com/theo-learner/codex-review-skills --skill codex-review-theo-learner

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Coders and teams often struggle to produce consistent, thorough reviews of code, plans, or documents, leading to overlooked issues and inconsistent feedback.

Core Features & Use Cases

  • Independent review of code, plans, and documents via Codex CLI, producing a structured CODEX_REVIEW.md with a published summary, issues, and actionable suggestions.
  • Supports multiple input modes: review current git changes with /codex-review, review a specified file with /codex-review path/to/PLAN.md, or review a document plus context with /codex-review --doc path/to/file.md.
  • Delivers a standardized review containing a Summary, Issues (HIGH/MEDIUM/LOW), Suggestions, and an Overall Risk assessment for reliable decision-making.

Quick Start

Ask Codex to review code, a plan, or a document by providing a path or using the --doc option.

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 review for git changes and output structured feedback?

Automate code review by running a command against current git changes to generate a structured CODEX_REVIEW.md file containing published summaries, categorized issues, and actionable suggestions.

Can I review a specific document or plan file independently for potential risks?

Yes, you can review a specific document or plan by providing its file path. The process independently analyzes the content and outputs a formal review with an overall risk assessment.

What is the best way to get consistent code review feedback across a development team?

The best way to get consistent feedback is to use an automated review process that delivers standardized outputs, ensuring every review includes a summary, severity-ranked issues, and suggestions.

Does automated document review work with additional context files?

Yes, automated document review supports context files. You can use the document plus context input mode to provide background information, ensuring the generated review is accurately informed.

How does an automated plan review assess overall project risk?

An automated plan review assesses project risk by analyzing the provided documents and generating a standardized review file that includes a dedicated overall risk assessment for reliable decision-making.

What formats and sections are included in an automated code review output?

Automated code review output is generated as a markdown file containing standardized sections including a Summary, categorized Issues ranked by severity, Suggestions, and an Overall Risk assessment.