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.

Codex CLI Configuration

Related skills

More from mryll/skills

Installs
24
Repository
mryll/skills
GitHub Stars
1
First Seen
Mar 5, 2026