Revision & Response Document (psychrev-rebuttal)
Write the response after the theory has actually been revised. At a theory journal a
response that argues rather than strengthens the model fails. Revise first, then document.
When to trigger
- A major/minor revision decision has arrived
- You have reviewer comments and must produce a point-by-point response
- You are tempted to defend the model rather than improve it
- You must decide which asks change the theory and which are presentation
Read the letter for the theory, not the edits
Reviewers at Psychological Review are usually proponents or critics of the rival models. Their
comments encode theoretical demands beneath the surface wording. Before drafting, classify
every comment:
| Comment encodes... |
Response strategy |
| "Your model is the same as [rival]" |
Sharpen subsumption/differentiation; show the limiting case (psychrev-contribution-framing) |
| "How do you know this prediction follows?" |
Add/strengthen the derivation (psychrev-argument-development) |
| "Couldn't a simpler account do this?" |
Add the head-to-head on a diagnostic phenomenon |
| "Is this parameter identifiable?" |
Add parameter-recovery simulation (psychrev-boundary-conditions) |
| "The model explains too much" |
State scope and a breakdown regime |
| "What would falsify it?" |
Add a risky novel prediction |
| "This reads as empirical / out of scope" |
Reframe so data only constrain; re-establish fit |
Building the response document
- Open with the substantive changes, not gratitude boilerplate: a short paragraph naming
the two or three ways the theory is now stronger (new derivation, identifiability analysis,
scope statement, head-to-head comparison).
- Point-by-point, quoting each comment, then: what you changed, where (section/figure/eq.
number), and — only where you genuinely disagree — a respectful, evidence-based rebuttal.
- Show the theory changed. For a theory journal, "we clarified the wording" rarely
suffices when the comment was about the model; point to the new derivation, simulation, or
scope statement.
- Concede on your own terms. Where a reviewer is right that the model cannot do Y, fold Y
into the boundary conditions as a stated limit rather than over-reaching to cover it.
- Disagree carefully. You may push back on a rival-modeler reviewer, but only with a
derivation or a diagnostic comparison — never with assertion. Make the editor's adjudication easy.
Tone and discipline
- Respectful, specific, and concrete — every claim of "we revised" carries a location.
- Never dismissive of the rival models the reviewers represent.
- Track changes / a clearly marked revised manuscript accompanies the response (per portal).
- If two reviewers conflict, surface the conflict for the editor and state your principled choice.
Checklist
Anti-patterns
- Arguing the model is fine instead of strengthening it (fatal at a theory journal)
- "We thank the reviewer" boilerplate with no located change
- Defending against a rival-modeler reviewer by assertion rather than derivation
- Over-reaching to cover a phenomenon a reviewer rightly flagged, instead of bounding it
- Cosmetic edits in response to a substantive theoretical objection
- Ignoring a reviewer conflict and hoping the editor does not notice
Output format
【Summary of strengthening】[2–3 ways the theory is now stronger]
【Point-by-point】[comment → change made → location | or reasoned rebuttal with derivation]
【Theory changes】[new derivations / simulations / scope statements added]
【Concessions】[phenomena now bounded out, on our terms]
【Editor notes】[any reviewer conflicts surfaced + principled choice]
【Next step】psychrev-submission (resubmission preflight)
Source: brycewang-stanford/Awesome-Journal-Skills → Psychological-Review-Skills/skills/psychrev-rebuttal/SKILL.md
1---2name: psychrev-rebuttal3description: Use when a Psychological Review decision letter (usually a major revision) has arrived and you must write the response document and revise the theory. Drafts the response and revision plan; it does NOT run the resubmission preflight (psychrev-submission) or build new theory from scratch (psychrev-theory-construction).4---5
6
7# Revision & Response Document (psychrev-rebuttal)
8
9> Write the response **after** the theory has actually been revised. At a theory journal a
10> response that argues rather than strengthens the model fails. Revise first, then document.
11
12## When to trigger
13
14- A major/minor revision decision has arrived
15- You have reviewer comments and must produce a point-by-point response
16- You are tempted to defend the model rather than improve it
17- You must decide which asks change the theory and which are presentation
18
19## Read the letter for the theory, not the edits
20
21Reviewers at Psychological Review are usually proponents or critics of the rival models. Their
22comments encode *theoretical* demands beneath the surface wording. Before drafting, classify
23every comment:
24
25| Comment encodes... | Response strategy |
26|-----------------------------------------------------|--------------------------------------------------|
27| "Your model is the same as [rival]" | Sharpen subsumption/differentiation; show the limiting case (`psychrev-contribution-framing`) |
28| "How do you know this prediction follows?" | Add/strengthen the derivation (`psychrev-argument-development`) |
29| "Couldn't a simpler account do this?" | Add the head-to-head on a diagnostic phenomenon |
30| "Is this parameter identifiable?" | Add parameter-recovery simulation (`psychrev-boundary-conditions`) |
31| "The model explains too much" | State scope and a breakdown regime |
32| "What would falsify it?" | Add a risky novel prediction |
33| "This reads as empirical / out of scope" | Reframe so data only constrain; re-establish fit |
34
35## Building the response document
36
371. **Open with the substantive changes**, not gratitude boilerplate: a short paragraph naming
38 the two or three ways the theory is now stronger (new derivation, identifiability analysis,
39 scope statement, head-to-head comparison).
402. **Point-by-point**, quoting each comment, then: what you changed, where (section/figure/eq.
41 number), and — only where you genuinely disagree — a respectful, evidence-based rebuttal.
423. **Show the theory changed.** For a theory journal, "we clarified the wording" rarely
43 suffices when the comment was about the model; point to the new derivation, simulation, or
44 scope statement.
454. **Concede on your own terms.** Where a reviewer is right that the model cannot do Y, fold Y
46 into the boundary conditions as a stated limit rather than over-reaching to cover it.
475. **Disagree carefully.** You may push back on a rival-modeler reviewer, but only with a
48 derivation or a diagnostic comparison — never with assertion. Make the editor's adjudication easy.
49
50## Tone and discipline
51
52- Respectful, specific, and concrete — every claim of "we revised" carries a location.
53- Never dismissive of the rival models the reviewers represent.
54- Track changes / a clearly marked revised manuscript accompanies the response (per portal).
55- If two reviewers conflict, surface the conflict for the editor and state your principled choice.
56
57## Checklist
58
59- [ ] Every reviewer comment addressed point-by-point, quoted, with a located change
60- [ ] Each theoretical ask answered with a *theory* change (derivation/simulation/scope), not just wording
61- [ ] Disagreements backed by derivation or diagnostic comparison, never bare assertion
62- [ ] Concessions folded into boundary conditions rather than over-reaching
63- [ ] Conflicting reviewer demands surfaced for the editor with a principled resolution
64- [ ] A summary of the main strengthening opens the document
65- [ ] Revised manuscript marked (track changes) and consistent with the response
66
67## Anti-patterns
68
69- Arguing the model is fine instead of strengthening it (fatal at a theory journal)
70- "We thank the reviewer" boilerplate with no located change
71- Defending against a rival-modeler reviewer by assertion rather than derivation
72- Over-reaching to cover a phenomenon a reviewer rightly flagged, instead of bounding it
73- Cosmetic edits in response to a substantive theoretical objection
74- Ignoring a reviewer conflict and hoping the editor does not notice
75
76## Output format
77
78```
79【Summary of strengthening】[2–3 ways the theory is now stronger]
80【Point-by-point】[comment → change made → location | or reasoned rebuttal with derivation]
81【Theory changes】[new derivations / simulations / scope statements added]
82【Concessions】[phenomena now bounded out, on our terms]
83【Editor notes】[any reviewer conflicts surfaced + principled choice]
84【Next step】psychrev-submission (resubmission preflight)
85```
86
87---
88
89**Source:** [`brycewang-stanford/Awesome-Journal-Skills`](https://github.com/brycewang-stanford/Awesome-Journal-Skills) → `Psychological-Review-Skills/skills/psychrev-rebuttal/SKILL.md`
thedixitjain