# revise-paper

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

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 240 repo stars
- Author: franklee16
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/franklee16/academic-research-skills/tree/HEAD/review-revise/revise-paper/SKILL.md
- Updated: 2026-09-18
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/revise-paper

## What it 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.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add franklee16/academic-research-skills --skill revise-paper -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/revise-paper/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/revise-paper/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add franklee16/academic-research-skills --skill revise-paper -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/revise-paper/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add franklee16/academic-research-skills --skill revise-paper -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/revise-paper/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install franklee16/academic-research-skills review-revise/revise-paper/SKILL.md
```

2. **Manually: put the files in place**
- File: `.github/skills/revise-paper/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add franklee16/academic-research-skills --skill revise-paper -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/franklee16/academic-research-skills --path review-revise/revise-paper
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/revise-paper/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/franklee16/academic-research-skills/tree/HEAD/review-revise/revise-paper/SKILL.md

## When to use it
- 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
- 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

## Similar
- [paper-audit](https://affpapa.org/en/nevibecode/skills/paper-audit.md) — skill · 3600 installs
- [paper-review-pipeline](https://affpapa.org/en/nevibecode/skills/paper-review-pipeline.md) — skill · ★ 475 repo stars
- [paper-editor](https://affpapa.org/en/nevibecode/skills/paper-editor.md) — skill · ★ 165 repo stars
- [paper-review](https://affpapa.org/en/nevibecode/skills/evoscientist-paper-review.md) — skill · 530 installs
- [paper-rebuttal](https://affpapa.org/en/nevibecode/skills/paper-rebuttal.md) — skill · 457 installs
- [typst-paper](https://affpapa.org/en/nevibecode/skills/typst-paper.md) — skill · 1600 installs

From the same set: [franklee16/academic-research-skills](https://affpapa.org/en/nevibecode/by/franklee16/academic-research-skills.md) — 98 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
