aris-auto-paper-improvement-loop

Iteratively improves LaTeX research papers via GPT-5.4 review, fix implementation, and recompilation.

1.1k|116|Updated Feb 26, 2026
One-click install
npx skills add https://github.com/OpenLAIR/dr-claw --skill aris-auto-paper-improvement-loop
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: aris-auto-paper-improvement-loop
Source: https://github.com/OpenLAIR/dr-claw/tree/main/skills/aris-auto-paper-improvement-loop
Command: npx skills add https://github.com/OpenLAIR/dr-claw --skill aris-auto-paper-improvement-loop

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Draft research papers often contain theoretical inconsistencies, overclaims, notation conflicts, and formatting violations that require multiple tedious rounds of manual review and revision before submission.

Core Features & Use Cases

  • Automated Review-Fix Loop: Sends the full paper text to GPT-5.4 (xhigh reasoning) via Codex MCP for a structured reviewer-style critique, then implements CRITICAL/MAJOR/MINOR fixes and recompiles with latexmk, for two rounds.
  • State Recovery & Logging: Persists progress in PAPER_IMPROVEMENT_STATE.json for context-compaction recovery and records every review and fix in PAPER_IMPROVEMENT_LOG.md with score progression.
  • Format Compliance Check: Detects overfull/underfull hbox warnings and page-limit violations, applying fixes like \resizebox or content moves to the appendix.
  • Use Case: After generating an ICLR paper draft, run the loop to raise the review score from 4/10 to 7/10 by fixing assumption mismatches, softening overclaims, and adding missing references—while preserving per-round PDFs for comparison.

Quick Start

Run the auto paper improvement loop on my compiled paper directory to review, fix, and recompile it for two rounds.

Frequently Asked Questions about aris-auto-paper-improvement-loop

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

FAQPage Schema
How do I automatically improve a generated research paper draft?

Run this skill on a compiled paper directory containing main.pdf and LaTeX sources. It sends the full text to GPT-5.4 for a structured review, implements fixes by severity, recompiles with latexmk, and repeats for two rounds.

How many review rounds does the paper improvement loop run?

It runs exactly two rounds of review, fix, and recompile. Testing shows Round 1 catches structural issues and Round 2 catches remaining presentation issues, with diminishing returns beyond two rounds for writing-only improvements.

Can I review and approve fixes before they are applied?

Yes, enable the human checkpoint option to pause after each round's review. You can approve all fixes, give custom modification instructions, skip specific fixes, or stop the loop early.

What happens if the context window fills up mid-loop?

The skill writes PAPER_IMPROVEMENT_STATE.json after each round with the current round, thread ID, and score. On restart, it reads this file plus the improvement log to resume from the next round if the state is less than 24 hours old.

Does the skill fix LaTeX formatting issues like overfull hbox?

Yes, after the final recompilation it checks page count against venue limits and scans the log for overfull and underfull hbox warnings. It applies fixes such as \resizebox, font reduction, or rephrasing, then recompiles.

Will the improvement loop add new experimental results to my paper?

No, the skill explicitly forbids fabricating experimental results. It softens overclaims, fixes inconsistencies, and may add synthetic validation subsections describing methodology, but never invents unsupported numbers or claims.