Paper Revision
Systematically revise papers based on reviewer feedback.
Input
$0— Reviewer comments/feedback$1— Current paper draft (main.tex or paper directory)
References
- Revision workflow and prompts:
~/.claude/skills/paper-revision/references/revision-prompts.md
Workflow
Step 1: Parse and Prioritize Concerns
For each reviewer comment:
- Extract the specific concern
- Classify: major revision, minor revision, question, suggestion
- Map to affected paper section(s)
- Prioritize: address major concerns first
Step 2: Plan Revisions
Create a revision plan:
Concern → Affected Section → Required Action → New Content/Experiment
Categories of actions:
- Clarification: Rewrite text for clarity
- Additional experiment: Run new experiment, add results
- New analysis: Add ablation, statistical test, or comparison
- Structural change: Move, merge, or split sections
- Citation: Add missing references
Step 3: Execute Revisions
For each planned revision:
- Read the current section
- Apply targeted edits (preserve surrounding structure)
- If new experiments needed: use experiment-code skill
- If new figures/tables needed: use figure-generation / table-generation skills
- Mark changes (use
\textcolor{blue}{...}for revised text)
Step 4: Verify Improvements
- Re-run self-review skill to check if scores improved
- Verify all reviewer concerns are addressed
- Check that revisions don't introduce new issues
- Ensure page count still fits venue requirements
Step 5: Write Revision Summary
Generate a diff summary:
- List all changes made with section references
- Note any new experiments, figures, or tables added
- Cross-reference each change to the reviewer concern it addresses
Rules
- Address EVERY reviewer concern — do not skip any
- Preserve paper structure unless structural change is explicitly needed
- New results must come from actual experiments, not hallucinated
- Mark all revised text clearly for the reviewers
- Keep a copy of the previous version before revising
- Compare new scores vs previous scores after revision
Related Skills
- Upstream: self-review
- Downstream: paper-compilation
- See also: rebuttal-writing, paper-writing-section