auto-review-loop

Automate multi-round review loops with fixes and re-reviews until positive assessment.

1|Updated Mar 24, 2026
One-click install
npx skills add https://github.com/kitcaf/skills --skill auto-review-loop-kitcaf
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: auto-review-loop
Source: https://github.com/kitcaf/skills/tree/main/skills/skills-codex/skills/auto-review-loop
Command: npx skills add https://github.com/kitcaf/skills --skill auto-review-loop-kitcaf

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Autonomously iterates through research reviews: reviews, implements fixes, and re-reviews until a positive assessment or MAX_ROUNDS is reached.

Core Features & Use Cases

  • Autonomous multi-round review loop that cycles: review → implement fixes → re-review, until a positive verdict or max rounds.
  • Configurable thresholds and persistence: MAX_ROUNDS, POSITIVE_THRESHOLD, REVIEW_DOC, and optional HUMAN_CHECKPOINT/COMPACT flags.
  • State persistence and recovery: writes REVIEW_STATE.json after each round; supports compact recovery and resuming from previous rounds.
  • Workflow phases: Phase A (Review), Phase B (Parse), Phase C (Implement Fixes), Phase D (Wait for Results), Phase E (Document Round) and Termination.

Quick Start

Start the loop with a topic to review and optional overrides for compact recovery or human checkpoints.

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 a research review loop to iteratively implement fixes until passing?

An autonomous research review loop automates iterative cycles of assessment, fix implementation, and re-review until a positive verdict or maximum round threshold is reached. It enforces a structured Phase A-E workflow with detailed logging to persistent documents.

How does state persistence work for long-running autonomous review workflows?

State persistence for long-running review workflows writes a JSON state file after each round, capturing progress and enabling recovery. This supports compact recovery and allows resuming the review process directly from previously completed rounds.

Can I configure a human checkpoint during an automated multi-round review process?

Yes, the automated multi-round review process supports optional human checkpoints. Enabling this flag pauses the autonomous workflow at defined phases, allowing manual oversight before continuing with fix implementation and re-review cycles.

What is the maximum number of review rounds allowed in an automated research review loop?

The maximum number of review rounds is defined by a configurable MAX_ROUNDS constant. The autonomous loop continuously cycles through review and fix implementation until either reaching this limit or achieving a positive assessment threshold.

How do I resume an interrupted autonomous review loop from a previous round?

To resume an interrupted autonomous review loop, the workflow utilizes compact recovery from the persistent JSON state file. This recovery mechanism reads the saved state to bypass completed phases and continue the review process from the exact interruption point.

When should I avoid using an autonomous multi-round review loop for research artifacts?

You should avoid an autonomous multi-round review loop when research artifacts require subjective human judgment beyond optional checkpoints, or when iterative automated fix implementation cannot adequately address the specific assessment criteria of your workflow.