Skills / brycewang-stanford/Auto-Empirical-Research-Skills / revise Try your first task revise
Start a fresh conversation. Replace the highlighted placeholders.
Use revise to assess [referee report] against [paper] , create the response tracker, and draft a response letter; mark new analyses TBD and flag disagreements for my review. Required inputs User-approved starter prompt based on a pinned source version; check current skill requirements before running. Task evidence ↗
name: revise description: R&R cycle — classify referee comments and route to appropriate agents. Replaces /respond-to-referee. argument-hint: "[referee-report file path] [paper path (optional)]" allowed-tools: Read,Grep,Glob,Write,Edit,Task Revise
Structure point-by-point referee responses with classification, agent routing per revision protocol, and diplomatic drafting.
Input: $ARGUMENTS — path to referee report file(s), optionally followed by paper path.
Workflow
Step 1: Parse Inputs
Read referee report(s) from $ARGUMENTS
Read the paper (paper/main.tex or specified path)
Read revision protocol from rules
Read existing scripts to know what analyses already exist
Step 2: Classify Every Comment
Step 3: Build Tracking Document
Save to quality_reports/referee_response_tracker.md with:
Summary counts per referee
Action items by priority (HIGH: new analysis, MEDIUM: clarification, FLAGGED: disagreements, LOW: minor)
Step 4: Dispatch Agents
CLARIFICATION/REWRITE → dispatch Writer with specific instructions
NEW ANALYSIS → flag for user approval before dispatching Coder
DISAGREE → draft diplomatic response, flag prominently for user
Step 5: Draft Response Letter
Generate LaTeX response letter with:
Summary of major changes
Point-by-point responses with exact referee quotes
Color-coded responses
Page/section references for each change
Step 6: Diplomatic Disagreement Protocol
When DISAGREE: open with acknowledgment, provide evidence, offer partial concession, NEVER say "the referee is wrong." FLAG for user review.
Step 7: Save Outputs
Tracker: quality_reports/referee_response_tracker.md
Response letter: quality_reports/referee_response_[journal]_[date].tex
Revised sections: paper/sections/ (for CLARIFICATION/REWRITE items)
Principles
The response letter is the user's voice. Match their tone.Never fabricate results. Mark NEW ANALYSIS items as TBD.Flag all DISAGREE items. These need human judgment.Track everything. Every comment appears in both tracker and response letter.