Agent skill

Auto Review Loop

by AI4Scientist in AI4Scientist/nano-scientist

Autonomous multi-round research review loop. An agent skill from AI4Scientist/nano-scientist.

No licenceAuto-check: warningsAgent Workflows

Install Auto Review Loop

The automated check flagged lines worth reading first. See the safety section below.

skills CLI
$ npx skills add AI4Scientist/nano-scientist --skill auto-review-loop -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install AI4Scientist/nano-scientist auto-review-loop --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/AI4Scientist/nano-scientist.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/auto-review-loop .claude/skills/auto-review-loop && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
auto-review-loop
GitHub stars
128
Used in
2 other repos
Token cost
~5.1k tokens
SKILL.md length
1,688 words
Files
1
Skills in repo
74
Repo updated
First seen
Licence
None found

At a glance

Autonomous multi-round research review loop. An agent skill from AI4Scientist/nano-scientist.

  • Works in 6 steps: Check for review-stage/REVIEW_STATE.json… → Read project narrative documents, memory… → Read recent experiment results (check… → …
  • User says auto review loop
  • SKILL.md covers Context: $ARGUMENTS, Constants, State Persistence (Compact… and Output Protocols, plus 4 more sections
  • Calls codex and curl; reaches dblp.org and doi.org

What it does

Auto Review Loop is an agent skill from AI4Scientist/nano-scientist. Autonomous multi-round research review loop. Repeatedly reviews via Codex MCP, implements fixes, and re-reviews until positive assessment or max rounds reached. Use when user says "auto review loop", "review until it passes", or wants autonomous iterative improvement.

Its SKILL.md is about 5.1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Agent Workflows. It works with Model Context Protocol and OpenAI. The repository describes itself as: An autonomous research agent that turns a topic into a peer-reviewed technical report.

When your agent uses it

  • User says auto review loop
  • Review until it passes
  • Wants autonomous iterative improvement

Example prompts

  • “auto review loop”
  • “review until it passes”
  • “/auto-review-loop”

Requirements

  • Pre-approved tools (allowed-tools): Bash(*), Read, Grep, Glob, Write, Edit, Agent, Skill, mcp__codex__codex, mcp__codex__codex-reply

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. Check for review-stage/REVIEW_STATE.json *(fall back to ./REVIEW_STATE.json if not found — legacy path)*
  2. Read project narrative documents, memory files, and any prior review documents. When COMPACT = true and compact files exist: read…
  3. Read recent experiment results (check output directories, logs)
  4. Identify current weaknesses and open TODOs from prior reviews
  5. Initialize round counter = 1 (unless recovered from state file)
  6. Create/update review-stage/AUTO_REVIEW.md with header and timestamp

What it can do on your machine

Read from SKILL.md and the folder at commit 7132192. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Bash(*)
    • Read
    • Grep
    • Glob
    • Write
    • Edit
    • Agent
    • Skill
    • mcp__codex__codex
    • mcp__codex__codex-reply

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • codex
    • curl

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • dblp.org
    • doi.org

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Auto Review Loop loads about 5.1k tokens when it runs. Until then it costs about 71 tokens; SKILL.md has 1,688 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~71
When it runs · the whole SKILL.md, loaded when a task matches
~5.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: warnings

The automated check found patterns that need a careful read before installing.

  • WarningTells the agent its actions are pre-authorized / not to stop for confirmationSKILL.md:425
    t << 'EOF' > file`) to write in chunks. Do NOT ask the user for permission — just do it silently.
  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Bash(*), Read, Grep, Glob, Write, Edit, Agent, Skill, mcp__codex__codex, mcp__codex__codex-reply

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 1,688 words (~5,055 tokens).

“Autonomously iterate: review → implement fixes → re-review, until the external reviewer gives a positive assessment or MAX_ROUNDS is reached.”

— opening of SKILL.md by AI4Scientist
name
auto-review-loop
allowed-tools
Bash(*), Read, Grep, Glob, Write, Edit, Agent, Skill, mcp__codex__codex, mcp__codex__codex-reply
argument-hint
topic-or-scope

Read the full SKILL.md on GitHub

Files

Just SKILL.md in skills/auto-review-loop of AI4Scientist/nano-scientist.

Open the folder on GitHubat commit 7132192

Used in 2 other repositories

We found 2 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 2 other GitHub owners. This page covers the copy in AI4Scientist/nano-scientist, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Auto Review Loop next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Auto Review Loop compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Auto Review Loop this skillAI4Scientist/nano-scientist1282 repos~5.1kAutomated safety check: WarnNone
Codex with ChatGPT Planning LoopXiaoDuoYa/codex-with-chatgpt7.1k—~11kAutomated safety check: NotesMIT
Cao MCP Appsawslabs/cli-agent-orchestrator1.4k—~1.9kAutomated safety check: PassApache-2.0
Chatgpt AppsHaohao-end/openagent8081 repos~4.9kAutomated safety check: PassApache-2.0
Chatgpt App Builderalpic-ai/skybridge2.1k—~1kAutomated safety check: PassMIT
Agent QA Authoringvostride/agent-qa903—~569Automated safety check: PassCustom licence

Similar skills

  • Codex with ChatGPT Planning Loop

    XiaoDuoYa/codex-with-chatgpt

    Uses ChatGPT in the browser as the planning and review brain for a Codex session, with Codex keeping all execution and ChatGPT reading the workspace through a bridge.

    7.1k GitHub stars~11k tokensUpdated 8 days ago
    Agent WorkflowsAuto-check: notes
  • Cao MCP Apps

    awslabs/cli-agent-orchestrator

    Official

    Enable, operate, and extend CAO's MCP Apps surface — the host-rendered fleet dashboard visible inside MCP App hosts (Claude Desktop, ChatGPT, VS Code Copilot, Goose, Postman).

    1.4k GitHub stars~1.9k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Chatgpt Apps

    Haohao-end/openagent

    Build, scaffold, refactor, and troubleshoot ChatGPT Apps SDK applications that combine an MCP server and widget UI.

    808 GitHub starsUsed in 1 repo~4.9k tokens
    Agent WorkflowsAuto-check passed
  • Chatgpt App Builder

    alpic-ai/skybridge

    Guide developers through creating and updating ChatGPT plugins.

    2.1k GitHub stars~1k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Agent QA Authoring

    vostride/agent-qa

    A skill your agent uses when creating, editing, validating, or running agent-qa tests, suites, or hooks.

    903 GitHub stars~569 tokensUpdated 2 mo ago
    Agent WorkflowsAuto-check passed
  • MCP Apps Builder

    awslabs/cli-agent-orchestrator

    Official

    Load the official MCP Apps builder skills (create-mcp-app, migrate-oai-app, add-app-to-server, convert-web-app) from github.com/modelcontextprotocol/ext-apps.

    1.4k GitHub stars~1.7k tokensUpdated today
    Agent WorkflowsAuto-check passed

More from AI4Scientist/nano-scientist

All 74 skills in this repo
  • Formula Derivation

    AI4Scientist/nano-scientist

    Structures and derives research formulas when the user wants to 推导公式, build a theory line, organize assumptions, turn scattered equations into a coherent derivation, or rewrite theory notes into a…

    128 GitHub starsUsed in 5 repos~2.3k tokens
    Auto-check passed
  • Paper Compile

    AI4Scientist/nano-scientist

    Compile LaTeX paper to PDF, fix errors, and verify output. An agent skill from AI4Scientist/nano-scientist.

    128 GitHub starsUsed in 5 repos~2.5k tokens
    Auto-check: notes
  • Paper Figure

    AI4Scientist/nano-scientist

    Generate publication-quality figures and tables from experiment results.

    128 GitHub starsUsed in 5 repos~2.9k tokens
    Auto-check: notes
  • Paper Navigator

    AI4Scientist/nano-scientist

    Find and read academic papers: disambiguate queries, discover papers (search, citation traversal, recommendations, arXiv monitoring, trending, GitHub search), evaluate (TLDR, citations, code, SOTA)…

    128 GitHub stars~7.7k tokensUpdated 4 mo ago
    Auto-check: notes
  • Proof Writer

    AI4Scientist/nano-scientist

    Writes rigorous mathematical proofs for ML/AI theory. An agent skill from AI4Scientist/nano-scientist.

    128 GitHub starsUsed in 5 repos~1.9k tokens
    Auto-check passed
  • Ablation Planner

    AI4Scientist/nano-scientist

    A skill your agent uses when main results pass result-to-claim (claimsupported=yes or partial) and ablation studies are needed for paper submission.

    128 GitHub starsUsed in 4 repos~1.3k tokens
    Auto-check: notes

Categories

Questions about Auto Review Loop

What does Auto Review Loop do?

Autonomous multi-round research review loop. An agent skill from AI4Scientist/nano-scientist. Auto Review Loop is an agent skill from AI4Scientist/nano-scientist. Autonomous multi-round research review loop.

When should I use Auto Review Loop?

Auto Review Loop fits situations like: user says auto review loop; review until it passes; wants autonomous iterative improvement.

How do I install Auto Review Loop in Claude Code?

Run `npx skills add AI4Scientist/nano-scientist --skill auto-review-loop -a claude-code`. Or copy the skill folder (skills/auto-review-loop in AI4Scientist/nano-scientist) into .claude/skills/auto-review-loop in your project. Claude Code loads it when a task matches its description.

How do I install Auto Review Loop in Codex?

Run `npx skills add AI4Scientist/nano-scientist --skill auto-review-loop -a codex`. Or copy the skill folder (skills/auto-review-loop in AI4Scientist/nano-scientist) into .agents/skills/auto-review-loop in your project. Codex loads it when a task matches its description.

Can I use Auto Review Loop in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add AI4Scientist/nano-scientist --skill auto-review-loop -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/auto-review-loop, .gemini/skills/auto-review-loop, .github/skills/auto-review-loop and .opencode/skills/auto-review-loop in your project.

What does Auto Review Loop need to run?

Going by SKILL.md and its folder, Auto Review Loop needs the command-line tools its instructions call (codex and curl). Its frontmatter pre-approves these tools: Bash(*), Read, Grep, Glob, Write, Edit, Agent, Skill, mcp__codex__codex, mcp__codex__codex-reply.

Does Auto Review Loop access the network?

SKILL.md names 2 domains. In commands or code: dblp.org and doi.org; the agent is likely to contact these when it follows the instructions. This is read from the text; nothing was executed.

Is Auto Review Loop safe to install?

Our automated static check of SKILL.md flagged 1 warning(s): tells the agent its actions are pre-authorized / not to stop for confirmation. Read the flagged lines before installing; the check is not a guarantee either way.

What licence does Auto Review Loop use?

No licence was found for Auto Review Loop or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Auto Review Loop use?

About 5.1k tokens (SKILL.md is roughly 20k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Auto Review Loop?

Skills that share tags, products or a category with Auto Review Loop: Codex with ChatGPT Planning Loop (XiaoDuoYa/codex-with-chatgpt, 7.1k stars), Cao MCP Apps (awslabs/cli-agent-orchestrator, 1.4k stars), Chatgpt Apps (Haohao-end/openagent, 808 stars) and Chatgpt App Builder (alpic-ai/skybridge, 2.1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Auto Review Loop?

AI4Scientist (a GitHub organization) maintains it in AI4Scientist/nano-scientist, which has 128 GitHub stars. The repository holds 74 skills in this directory. The repository was last updated on June 3, 2026.

Source: AI4Scientist/nano-scientist on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.