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
npx skills add franklee16/academic-research-skills --skill revise-paper -a claude-codeWhat 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
.texor.docxmanuscript - 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 revisepaper.tex - Handle the reviewer comments on
main.docxand 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-code2Manually: put the files in place
~/.claude/skills/revise-paper/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/revise-paper/
1Skills CLI (Vercel)
npx skills add franklee16/academic-research-skills --skill revise-paper -a codex2Manually: put the files in place
.agents/skills/revise-paper/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add franklee16/academic-research-skills --skill revise-paper -a cursor2Manually: put the files in place
.cursor/skills/revise-paper/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install franklee16/academic-research-skills review-revise/revise-paper/SKILL.md2Manually: put the files in place
.github/skills/revise-paper/SKILL.md1Skills CLI (Vercel)
npx skills add franklee16/academic-research-skills --skill revise-paper -a gemini-cli2Platform CLI
gemini skills install https://github.com/franklee16/academic-research-skills --path review-revise/revise-paperManually: put the files in place
.devin/skills/revise-paper/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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.