Skip to main content
skill CX Codex

revise-paper — Claude Code skill: revise a paper from referee reports

revise-paper turns referee reports into a deduplicated checklist, edits a LaTeX or Word manuscript against it, then writes the reply to the reviewers.

no license ★ 240 updated 2026-09-18

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add franklee16/academic-research-skills --skill revise-paper -a claude-code
Open on GitHub

What revise-paper does

Give it a manuscript and a folder of referee reports. The skill splits every report into single remarks, numbers them (R1-C3), tags each with a class (NEW_ANALYSIS, CLARIFICATION, REWRITE, DISAGREE, MINOR) and a severity, then merges remarks that repeat across reviewers. The result lands in quality_reports/revision_checklist_[DATE].json. Issues are grouped by section and table, parallel editing agents work through the groups, and every change is committed to git.

After each batch the paper gets compiled and checked, with automatic fixes where the build complains. Once the edits are in, you get a reply letter addressed to the reviewers. A plain request is enough to start; leave the paths out and the skill looks for main.tex, paper.tex or quality_reports/referee_reports/ by itself. Progress goes to quality_reports/revision_progress.md.

LaTeX work needs xelatex, or pdflatex as the fallback, and the build runs xelatex → biber → xelatex → xelatex. Word files need python; the skill installs python-docx and markitdown with pip when they are missing. A remark that fits two categories equally well stops the pipeline for your call, so nothing gets rewritten on a guess.

What it helps with

  • turn several referee reports into one checklist without repeats
  • apply reviewer comments to a .tex or .docx manuscript
  • recompile the PDF after each batch of edits
  • draft a point-by-point reply to the reviewers
  • flag the comments that need an author's decision

Example prompts for the agent

  • Go through the referee reports in referee_reports/ and revise paper.tex
  • Handle the reviewer comments on main.docx and draft the response letter
  • Parse these reviews into a checklist and tell me which items need my call

How to install revise-paper

1Skills CLI (Vercel)

npx skills add franklee16/academic-research-skills --skill revise-paper -a claude-code

2Manually: put the files in place

~/.claude/skills/revise-paper/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/revise-paper/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about revise-paper

How do I install revise-paper in Claude Code?

Run npx skills add franklee16/academic-research-skills --skill revise-paper -a claude-code. The skill then sits at ~/.claude/skills/revise-paper/SKILL.md.

What does revise-paper do?

It reads a paper and a folder of referee reports, builds a deduplicated checklist of issues, applies edits through parallel agents with git commits, recompiles after each batch and writes the response letter to the reviewers.

What has to be installed for it to work?

LaTeX papers need xelatex, with pdflatex as the fallback. Word papers need python, and python-docx plus markitdown are installed through pip if missing.

Similar skills

All skills for Science and research →

From the same set98

The whole set →
proof-readability proof-readability edits a math proof that already passed verification so a reader can follow it in one go: reordered steps, added lead-ins, fixed references. The claims stay as they are. CX Codex +1 ★ 240repo stars management-science-writing The management-science-writing skill guides management science and operations research papers from topic and journal choice through modeling, algorithms, experiments, and managerial conclusions. CX Codex +1 ★ 240repo stars mhe-identification mhe-identification evaluates causal identification strategies and drafts endogeneity sections for empirical papers using principles from applied econometrics. CX Codex +1 ★ 240repo stars paper-spine The paper-spine skill guides research-paper rewrites around a confirmed motivation, venue requirements, and evidence from the author’s materials. Use it for structural revision, not a quick prose polish. CX Codex +1 ★ 240repo stars theoretical-economics-claude-skill theoretical-economics-claude-skill guides an economic intuition or puzzle into a working paper scaffold across structured stages with quality gates and human reviews. CX Codex +1 ★ 240repo stars citation-management citation-management pulls papers from Google Scholar and PubMed, turns DOI, PMID and arXiv IDs into clean metadata, and writes BibTeX you can drop into a manuscript. CX Codex +1 ★ 240repo stars thu-digitizer The thu-digitizer skill extracts numeric values from chart images and PDFs, then checks the results. Use it when you need plotted data rather than a visual estimate. CX Codex +1 ★ 240repo stars beautiful_deck beautiful_deck builds or reshapes Beamer presentations, including the theme, code-generated visuals, compiled PDF, walkthrough scripts, and graphics checks. CX Codex +1 ★ 240repo stars

Project sponsors

Companies that keep this analytics open