franklee16

Paper Revision — Development skill for Claude Code

Development community

Claude Code skill for handling journal Revise and Resubmit (R&R) decisions.

How to install Paper Revision

This entry records only its repository, not the path inside it, so there is no exact command to give. Open franklee16/paper-revision and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Paper Revision does

Claude Code skill for handling journal Revise and Resubmit (R&R) decisions.

Alternatives in Development

PaperSpine — PaperSpine is a motivation-driven skill for learning from strong academic papers, building a paper’s central a 5k ★
Ars Revision Coach — ARS academic-paper revision-coach mode — Revision Roadmap + Response Letter Skeleton 4.5k ★
Symfony Messenger — Implement async message handling with Symfony Messenger 206 ★

README

paper-revision

A Claude Code skill for systematically handling journal Revise and Resubmit (R&R) decisions — from extracting referee comments to drafting the response letter.

Based on [Tanya Golash-Boza's proven R&R method](https://tanyagolashboza.com/the-professor-is-in-how-to-write-a-peer-journal-article-revision/).

Quick Start

# 1. Parse referee reports into a structured tracker
python scripts/parse_referee_report.py referee1.pdf --output comments1.csv
python scripts/parse_referee_report.py referee2.txt --output comments2.csv

# 2. Classify comments and plan responses in the tracker

# 3. Generate a LaTeX response letter from the completed tracker
python scripts/generate_response_letter.py revision_tracker.csv \
  --output response_letter.tex \
  --title "Your Paper Title" \
  --author "Your Name"

The 10-Step Workflow

Step	Action	Output
1	Read the editor's letter — confirm R&R decision	Decision type
2	Create revision tracker	`revision_tracker.csv`
3	Extract all comments from each review	Raw comment list
4	Organize comments by section	Grouped tracker
5	Classify each comment (4 categories)	Classification column filled
6	Plan your response for each comment	Response Action column filled
7	Execute revisions (MINOR → CLARIFICATION → NEW ANALYSIS)	Revised manuscript
8	Write the response letter	`response_letter.tex`
9	Double-check completeness	Verification checklist
10	Final read and resubmit	Submission package

Comment Classification

Every referee comment falls into one of four categories, each with its own workflow:

Classification	Meaning	Routing
NEW ANALYSIS	New estimation, robustness tests, data work	Coder → coder-critic → writer
CLARIFICATION	Text revision sufficient — no new code	Writer → writer-critic
DISAGREE	Pushback needed — misguided or inf