# paper-revision

paper-revision is a Claude Code skill that organizes referee feedback, plans manuscript changes, and drafts a response letter for journal revision.

- 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/paper-revision-master/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/franklee16-paper-revision

## What it does

The skill turns referee feedback into a revision tracker. It groups comments by manuscript section and sorts them into new analysis, clarification, disagreement, or minor edits. The `scripts/parse_referee_report.py` utility can extract comments from a PDF or text report and create the initial tracker.

Use the completed tracker to prepare a letter with replies to reviewers and the editor. A LaTeX template is provided at `assets/response_letter_template.tex`, and `scripts/generate_response_letter.py` creates a draft from the tracker. Disagreement needs user approval; the skill is not meant to reject a referee request on its own. For requests requiring new analysis, the workflow calls for code in R, Stata, or Python and updated manuscript results.

## Install

### Claude Code (native platform)

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

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

### Codex

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

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

### Cursor

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

2. **Manually: put the files in place**
- File: `.cursor/skills/paper-revision-master/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/paper-revision-master/SKILL.md
```

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/paper-revision-master/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/paper-revision-master/SKILL.md

## When to use it
- turn referee reports into a structured comment tracker
- sort reviewer feedback by manuscript section and response type
- plan a manuscript change for each reviewer comment
- draft a response letter from the completed tracker

## Example prompts
- Extract the comments from `referee_report.pdf` and create `revision_tracker.csv`.
- Group the referee comments by manuscript section and assign a response category to each.
- Draft a response letter from `revision_tracker.csv` for the paper titled “Your Paper Title”.

## 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
- [academic-research](https://affpapa.org/en/nevibecode/skills/academic-research.md) — skill · 148 installs

## Other versions with the same name
- [paper-revision · lingzhi227](https://affpapa.org/en/nevibecode/skills/paper-revision.md) — 1900 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
