Paper Revision — Development skill for Claude Code

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