codex-review
Installation
SKILL.md
Codex Review — Iterative Consensus Skill
Orchestrate an iterative debate between the local agent and Codex CLI until both reach consensus on code review findings, architecture decisions, or implementation plans.
Guiding principle: KISS (Keep It Simple, Stupid). Both sides should favor the simplest solution that works. Complexity must be justified.
Codex Independence
Codex is an independent reviewer, not a compliance checker. Do NOT instruct Codex to validate against AGENTS.md / CLAUDE.md conventions or treat them as rules to follow. Codex should form its own engineering opinions based on the code/plan it reads.
- The local agent follows the project's AGENTS.md / CLAUDE.md conventions (it already does naturally)
- Codex reviews with its own engineering judgment — it may agree with, be unaware of, or even challenge AGENTS.md / CLAUDE.md conventions
- When they disagree: the local agent may cite AGENTS.md / CLAUDE.md as one argument, but Codex is free to push back if it has a better reasoning. The debate resolves on merits, not authority.
- If truly unresolved: flag it for the user to decide
Give Codex only a brief project description (what it does, tech stack) for context — not a rulebook.