Skip to content

Auto Paper Improvement Loop

Iteratively review, fix and recompile a generated paper using a Gemini reviewer, for two rounds.

Stars
18,482
Licence
MIT
Files
1 file

What it does

This skill makes an agent take an already-compiled research paper (a PDF plus LaTeX source) and improve its writing automatically. It sends the paper text to a Gemini model acting as a reviewer through an MCP bridge, reads back a score and a ranked list of weaknesses, edits the LaTeX to fix them, and recompiles, repeating for two rounds. It focuses on writing quality such as claim calibration, narrative structure and clarity, not on running new experiments. It is meant to be installed after the companion skills/skills-codex package.

Great for

  • Researchers who already have a compiled LaTeX draft and want a structured second-opinion pass on wording and framing
  • Codex users who want Gemini rather than a second Codex agent as the reviewer

Skip it if

  • Papers that still need new experiments or data, since the skill only edits writing and the file itself says research iteration is a different skill (/auto-review-loop)
  • Unreviewed submissions where the agent's edits could subtly change facts, numbers or scope; the skill should be read and checked by the author before submission

Try asking

  • “Improve the paper at paper/ using the Gemini review loop”
  • “auto improve my compiled paper before I send it to my advisor”
  • “Run the paper polishing loop with human checkpoint enabled so I can approve fixes”
Step-by-step guide: how to use Auto Paper Improvement LoopInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 1 original files, the MIT licence and an attribution note.

    auto-paper-improvement-loop.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip auto-paper-improvement-loop.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip auto-paper-improvement-loop.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Keep the original PDF backup the skill creates (main_round0_original.pdf) and review the diff after each round before accepting changes
  • Enable the human checkpoint to approve or skip fixes if you do not want fully autonomous edits
  • Set GEMINI_REVIEW_MODEL if you need a specific Gemini model; the paper text is sent to the external Gemini service, so check that this is acceptable for unpublished work

What's inside

  • SKILL.md

Redistributed unmodified from wanshuiyin/Auto-claude-code-research-in-sleep under the MIT licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.