Codex Review Loop
douglaz/skills
Loop automático de revisão e correção de código com múltiplas iterações
Ver no GitHubSkill que executa um ciclo iterativo de revisão, correção e re-revisão de código usando Codex. Detecta problemas, trata findings como críveis até refutados, aplica correções, valida o código alterado e repete até ficar limpo ou atingir o limite de passes.
Instalação
npx convez-ai douglaz/skills1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Hardening incremental de branches antes de merge
- Detecção e correção automática de anti-patterns de código
- Validação iterativa de qualidade até atingir padrões de limpeza
Veredito

Skill robusta para automação de revisão de código em fluxos de CI/CD. Melhor aplicada em cenários onde você quer múltiplas passadas de refinamento antes de integração, com rastreamento explícito de findings resolvidos. Requer familiaridade com Codex e fluxos de branching Git.
README
A tradução para o português deste README ainda está na fila.
skills
A collection of skills for Claude Code and OpenAI Codex.
The Flywheel bead skills in this repo intentionally stick to the shared agent-skills format so they can work in both tools.
Available skills
codex-review-loop
Runs an iterative Codex review/fix/re-review loop on your current branch. Detects a review base, runs codex review, treats findings as credible until disproven, fixes accepted items, validates the changed code, and repeats until clean or the pass limit is reached.
/codex-review-loop # up to 6 passes (default)
/codex-review-loop 3 # up to 3 passes
/codex-review-loop 5 focus on error handling # 5 passes, focused review
Best fit: Claude Code explicit invocation. This skill shells out to codex review and is most natural when run as a slash command from Claude Code.
complexity-reducer
Reduces code complexity by deleting, collapsing, inlining, and simplifying code while preserving behavior. Rust-first, with guidance that also applies to Bash and other languages.
Claude Code:
/complexity-reducer simplify this Rust module without changing behavior
Codex:
Use the complexity-reducer skill to reduce ceremony in this code while preserving behavior.
plan-to-beads-transfer
Translates a stable spec, PRD, or markdown plan into actual br beads with
self-contained descriptions, explicit dependencies, and verification
obligations.
Claude Code:
/plan-to-beads-transfer docs/PLAN.md
Codex:
Use the plan-to-beads-transfer skill on docs/PLAN.md.
bead-polish-loop
Runs repeated bead-graph refinement rounds for coverage, deduplication, dependency repair, sizing, priority, and verification completeness until the graph converges.
Claude Code:
/bead-polish-loop
Codex:
Use the bead-polish-loop skill on the current bead graph.
second-model-bead-audit
Provides an independent audit of an existing bead graph against the plan, with blocking findings first and exact bead-level fixes when obvious.
Claude Code:
/second-model-bead-audit docs/PLAN.md
Codex:
Use the second-model-bead-audit skill and give me a launch verdict.
orchestrating-with-ralph-burning
Uses ralph-burning as the default structured workflow for substantial
implementation work: requirements, project creation, flow selection, run
start/resume, and canonical status inspection.
Claude Code:
/orchestrating-with-ralph-burning implement retry-safe daemon lease cleanup
Codex:
Use the orchestrating-with-ralph-burning skill to implement this with ralph-burning.
codex-review-beads-ralph-loop
Composes codex review + br beads + ralph-burning into a harden-until-clean
loop on a work branch. Each codex review finding becomes a tracked bead; each
bead gets solved via its own ralph-burning minimal run on a dedicated
feature branch, through PR and merge; after every batch of merges the
review is rerun. Stops when the review is clean or the same finding
survives two full iterations.
Claude Code:
/codex-review-beads-ralph-loop harden this branch against main
Codex:
Use the codex-review-beads-ralph-loop skill to drive codex+beads+ralph until this branch is clean.
Best fit: you want durable, bead-tracked regression sweeps with one PR per
finding, not the inline-edit style of codex-review-loop.
Install
curl -fsSL https://raw.githubusercontent.com/douglaz/skills/master/install.sh | bash
Or clone and run manually:
git clone https://github.com/douglaz/skills.git
cd skills
./install.sh
By default, install.sh clones this repo into
~/.local/share/douglaz-skills and installs skills into both
~/.claude/skills and Codex. Codex installs go to ~/.codex/skills on
current setups, with fallback to the legacy ~/.agents/skills layout when
that is the only Codex skills directory present. Use --target claude or
--target codex to install into only one tool.
If a target skill path already exists as a plain directory instead of a
symlink, the installer now treats that as a conflict and exits non-zero after
reporting the partial install. When the directory looks like a copied skill
from this repo, rerun with --migrate-existing to rename it to
<skill>.backup.<timestamp> and replace it with a symlink.
Install specific skills:
./install.sh codex-review-loop
./install.sh --target claude codex-review-loop
./install.sh --target codex plan-to-beads-transfer bead-polish-loop second-model-bead-audit orchestrating-with-ralph-burning
./install.sh plan-to-beads-transfer bead-polish-loop second-model-bead-audit orchestrating-with-ralph-burning
./install.sh --target codex --migrate-existing plan-to-beads-transfer bead-polish-loop second-model-bead-audit
./install.sh --target codex complexity-reducer
Uninstall
./install.sh --uninstall
./install.sh --target both --uninstall
./install.sh --target codex --uninstall
--uninstall removes installer-managed symlinks. It does not remove backup
directories created by --migrate-existing.
Prerequisites
- Claude Code for Claude installation targets
- OpenAI Codex CLI for Codex installation targets
codexonPATHforcodex-review-loopandcodex-review-beads-ralph-loopbrandbvonPATH, plus a repo that uses.beads/, forplan-to-beads-transfer,bead-polish-loop,second-model-bead-audit, andcodex-review-beads-ralph-loopralph-burningonPATH, ornix run github:douglaz/ralph-burning -- ..., fororchestrating-with-ralph-burningandcodex-review-beads-ralph-loopghauthenticated forcodex-review-beads-ralph-loop(PR creation and merge)
License
MIT