codex-review

Review design docs and implementation plans to surface issues before implementation.

1|Updated Dec 30, 2025
One-click install
npx skills add https://github.com/jrajasekera/claude-skills --skill codex-review-jrajasekera
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: codex-review
Source: https://github.com/jrajasekera/claude-skills/tree/main/skills/codex-review
Command: npx skills add https://github.com/jrajasekera/claude-skills --skill codex-review-jrajasekera

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Cross-agent review of design docs or implementation plans to surface issues and improve quality before implementation.

Core Features & Use Cases

  • Auto-triggers for non-trivial plan changes to initiate Codex feedback.
  • Captures feedback, surfaces critical issues, and presents minor concerns for user decision.
  • Facilitates structured review rounds and decision capture.

Quick Start

Use codex-review to analyze your latest plan.md and receive structured feedback.

Frequently Asked Questions about codex-review

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

FAQPage Schema
How do I get automated feedback on design docs and implementation plans?

You can get automated feedback on design docs by triggering cross-agent review to surface critical issues and minor concerns before implementation begins. The tool captures structured feedback for your decision-making process.

What is cross-agent review for non-trivial plan changes?

Cross-agent review for non-trivial plan changes is an automated feedback mechanism that analyzes design documents and implementation plans to surface quality issues and present them for user decision before coding starts.

How do I review a plan.md file to surface critical issues before implementation?

To review a plan.md file, use the automated review feature to capture feedback, distinguish critical issues from minor concerns, and present them in structured review rounds for your decision.

Does codex-review auto-trigger for minor plan modifications?

The tool auto-triggers specifically for non-trivial plan changes to initiate feedback, while also designed to surface simple changes for quick review without full structured review rounds.

Can I capture structured review decisions for implementation plans?

Yes, you can capture structured review decisions as the tool facilitates review rounds, presents critical issues and minor concerns, and records your decisions on the feedback before implementation proceeds.

When should I avoid using automated design doc review?

You should avoid automated design doc review for trivial plan modifications that require no structural validation, as the tool is built to surface issues in non-trivial changes and may add unnecessary overhead for simple updates.