REStud Rebuttal (restud-rebuttal)
When to trigger
- A decision letter with referee reports has arrived (R&R, or reject-and-resubmit)
- The user has a revised draft and needs the response letter
- The user is unsure which comments to concede, clarify, or push back on
- Multiple referees disagree and the response must reconcile them without contradiction
REStud revision philosophy
REStud is known for developing strong papers across rounds with demanding referees. Treat the R&R as a collaboration, not a defense: the editor wants the paper to become publishable. The strongest response revises the manuscript first, then writes the letter against the revised version — never the other way around. Two REStud-specific facts to plan for: (1) review is double-anonymous, so address "Referee 2" by number and keep replies anonymizable; (2) acceptance is conditional on the Data Editor's pre-publication reproducibility check (AEA DCAS, Zenodo deposit — see restud-replication-package), so a revision that adds empirical results must keep the replication package in lockstep — do not promise a number you cannot regenerate from the deposit. Push new proofs and bulky robustness into the online appendix and point to them from the letter.
Triage every comment
Classify each referee point into one of four actions:
- Concede + fix. The referee is right; make the change and say so plainly. Most comments are this. Conceding gracefully builds credibility for the few points you contest.
- Clarify. The referee misread because the text was unclear. Fix the text so the next reader does not misread, then explain the clarification. Do not just say "the referee misunderstood" — that blames the reader.
- Push back (rarely). The referee is wrong on substance. Push back only with evidence — a citation, a new result, a proof — and only on points that matter. Pick these battles sparingly.
- Decline (rarely, with reason). A request is out of scope or would change the paper into a different paper. Decline respectfully, explain why, and offer the smaller version of what they want if possible.
The response letter
Structure:
- Cover note to the editor. Thank the editor, summarize the main changes in a short paragraph, and flag any place where referees disagreed and how you reconciled them.
- Per-referee sections. For each referee, restate each comment (quoted or paraphrased faithfully), then the response: the action taken and the exact location in the revised manuscript (section, page, table number).
- Tone: professional, specific, non-defensive. Every "we have done X" must point to where.
Format each response as:
Comment R2.3: "[faithful quote of the referee's point]"
Response: We agree / We have clarified / We respectfully note ...
Change: [what changed] — see Section 4.2, p. 14, and new Table 5.
Reconciling conflicting referees
When two referees want opposite things, do not silently satisfy one and ignore the other. State the tension to the editor, choose the resolution that serves the paper, and explain the choice. The editor adjudicates — give them what they need to back you.
Checklist
Anti-patterns
- Writing the letter against the old draft, so "see p. 14" points to the wrong place
- "The referee misunderstood" with no text fix — blaming the reader
- Pushing back on many points; it reads as unwillingness to revise
- Conceding a point in the letter but not actually changing the manuscript
- Silently ignoring one of two conflicting referees
- A letter that argues the paper's importance instead of answering the comments
Output format
【DECISION TYPE】R&R | reject-and-resubmit | minor revision
【COMMENTS TRIAGED】concede X / clarify Y / push-back Z / decline W
【MANUSCRIPT REVISED FIRST】yes / no
【CONFLICTS RECONCILED】[...]/none
【LETTER STATUS】drafted with exact-location cites
【NEXT SKILL】restud-submission (resubmit) | restud-robustness (if new results needed)
Source: brycewang-stanford/Awesome-Journal-Skills → Review-of-Economic-Studies-Skills/skills/restud-rebuttal/SKILL.md
1---2name: restud-rebuttal3description: Use when a referee report or R&R has arrived for a The Review of Economic Studies (REStud) manuscript and a point-by-point response letter plus aligned manuscript revisions are needed. Structures the revision and the letter; does not redo the science from scratch.4---5
6
7# REStud Rebuttal (restud-rebuttal)
8
9## When to trigger
10
11- A decision letter with referee reports has arrived (R&R, or reject-and-resubmit)
12- The user has a revised draft and needs the response letter
13- The user is unsure which comments to concede, clarify, or push back on
14- Multiple referees disagree and the response must reconcile them without contradiction
15
16## REStud revision philosophy
17
18REStud is known for **developing strong papers across rounds** with demanding referees. Treat the R&R as a collaboration, not a defense: the editor wants the paper to become publishable. The strongest response **revises the manuscript first, then writes the letter against the revised version** — never the other way around. Two REStud-specific facts to plan for: (1) review is **double-anonymous**, so address "Referee 2" by number and keep replies anonymizable; (2) acceptance is conditional on the **Data Editor's pre-publication reproducibility check** (AEA DCAS, Zenodo deposit — see `restud-replication-package`), so a revision that adds empirical results must keep the replication package in lockstep — do not promise a number you cannot regenerate from the deposit. Push new proofs and bulky robustness into the **online appendix** and point to them from the letter.
19
20## Triage every comment
21
22Classify each referee point into one of four actions:
23
241. **Concede + fix.** The referee is right; make the change and say so plainly. Most comments are this. Conceding gracefully builds credibility for the few points you contest.
252. **Clarify.** The referee misread because the text was unclear. Fix the text so the *next* reader does not misread, then explain the clarification. Do not just say "the referee misunderstood" — that blames the reader.
263. **Push back (rarely).** The referee is wrong on substance. Push back only with evidence — a citation, a new result, a proof — and only on points that matter. Pick these battles sparingly.
274. **Decline (rarely, with reason).** A request is out of scope or would change the paper into a different paper. Decline respectfully, explain why, and offer the smaller version of what they want if possible.
28
29## The response letter
30
31Structure:
32
33- **Cover note to the editor.** Thank the editor, summarize the main changes in a short paragraph, and flag any place where referees disagreed and how you reconciled them.
34- **Per-referee sections.** For each referee, restate each comment (quoted or paraphrased faithfully), then the response: the action taken and **the exact location in the revised manuscript** (section, page, table number).
35- **Tone:** professional, specific, non-defensive. Every "we have done X" must point to where.
36
37Format each response as:
38
39```
40Comment R2.3: "[faithful quote of the referee's point]"
41Response: We agree / We have clarified / We respectfully note ...
42Change: [what changed] — see Section 4.2, p. 14, and new Table 5.
43```
44
45## Reconciling conflicting referees
46
47When two referees want opposite things, do not silently satisfy one and ignore the other. State the tension to the editor, choose the resolution that serves the paper, and explain the choice. The editor adjudicates — give them what they need to back you.
48
49## Checklist
50
51- [ ] Manuscript revised *before* the letter was written
52- [ ] Every comment triaged (concede / clarify / push back / decline)
53- [ ] Each response cites the exact revised location (section, page, exhibit)
54- [ ] Push-backs are evidence-backed and few
55- [ ] Declines are respectful and offer a smaller alternative
56- [ ] Conflicting referee requests reconciled explicitly for the editor
57- [ ] Tone professional and non-defensive throughout
58
59## Anti-patterns
60
61- Writing the letter against the old draft, so "see p. 14" points to the wrong place
62- "The referee misunderstood" with no text fix — blaming the reader
63- Pushing back on many points; it reads as unwillingness to revise
64- Conceding a point in the letter but not actually changing the manuscript
65- Silently ignoring one of two conflicting referees
66- A letter that argues the paper's importance instead of answering the comments
67
68## Output format
69
70```
71【DECISION TYPE】R&R | reject-and-resubmit | minor revision
72【COMMENTS TRIAGED】concede X / clarify Y / push-back Z / decline W
73【MANUSCRIPT REVISED FIRST】yes / no
74【CONFLICTS RECONCILED】[...]/none
75【LETTER STATUS】drafted with exact-location cites
76【NEXT SKILL】restud-submission (resubmit) | restud-robustness (if new results needed)
77```
78
79---
80
81**Source:** [`brycewang-stanford/Awesome-Journal-Skills`](https://github.com/brycewang-stanford/Awesome-Journal-Skills) → `Review-of-Economic-Studies-Skills/skills/restud-rebuttal/SKILL.md`