auto-review-loop

Automate iterative review cycles of research artifacts via Codex MCP until positive assessment.

Updated Mar 17, 2026
One-click install
npx skills add https://github.com/loujc/Auto-claude-code-research-in-sleep-manual --skill auto-review-loop-loujc
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: auto-review-loop
Source: https://github.com/loujc/Auto-claude-code-research-in-sleep-manual/tree/main/skills/auto-review-loop
Command: npx skills add https://github.com/loujc/Auto-claude-code-research-in-sleep-manual --skill auto-review-loop-loujc

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates the end-to-end process of reviewing research artifacts, applying fixes, and re-evaluating until a positive assessment is achieved, reducing manual review time and human workload.

Core Features & Use Cases

  • Autonomous review loop: Score, critique weaknesses, and propose minimal fixes; executes fixes or flags for human intervention; persists state across rounds.
  • Iterative refinement: Repeats review-implement-review until MAX_ROUNDS or acceptance threshold is reached for manuscripts, code, or experiments.
  • Flexible collaboration: Works with Codex MCP as reviewer and external models as executor in cross-model review setups; supports human checkpoint when enabled.

Quick Start

Start the auto-review-loop to iteratively review, implement fixes, and re-review until a positive assessment or the maximum rounds are reached.

Frequently Asked Questions about auto-review-loop

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

FAQPage Schema
How do I automate the research review cycle for manuscripts and code?

An autonomous review loop automates iterative refinement by scoring research artifacts, applying minimal fixes, and re-evaluating until a positive threshold is reached. It reduces manual review time by persisting state across rounds and recording reviewer responses automatically.

How does the iterative review loop work with Codex MCP?

The iterative review loop uses Codex MCP as an external reviewer to score artifacts and propose fixes, while an executor model implements the changes. It persists state across rounds in REVIEW_STATE.json and records responses in AUTO_REVIEW.md until acceptance or maximum rounds.

Can I use an external model as the executor while Codex MCP acts as the reviewer?

Yes, this setup supports cross-model review configurations where Codex MCP serves as the reviewer and an external model acts as the executor. It enables autonomous review-implement cycles with optional human checkpoints when enabled.

What happens when the autonomous review loop reaches the maximum rounds without a positive assessment?

When MAX_ROUNDS are reached without meeting the POSITIVE_THRESHOLD, the loop terminates. The detailed state and reviewer responses remain persisted in REVIEW_STATE.json and AUTO_REVIEW.md for human inspection and intervention.

What types of research artifacts can be processed through the autonomous review loop?

The autonomous review loop applies to multi-round review scenarios for academic manuscripts, code, and experiments. It handles any technical project artifacts where an executor and external reviewer collaborate across iterations for iterative refinement.