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).
Installs into .claude/skills of the current project.
Are you the author of Psychrev Rebuttal?
Add the live security badge to your README. It updates with every re-scan.
[](https://www.skillsdirectory.com/skills/thedixitjain-psychrev-rebuttal)
---
name: psychrev-rebuttal
description: "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)."
category: general-purpose
source_repo: brycewang-stanford/Awesome-Journal-Skills
source_path: "Psychological-Review-Skills/skills/psychrev-rebuttal/SKILL.md"
source_url: https://github.com/brycewang-stanford/Awesome-Journal-Skills/blob/HEAD/Psychological-Review-Skills/skills/psychrev-rebuttal/SKILL.md
---
# 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
1. **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).
2. **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.
3. **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.
4. **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.
5. **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
- [ ] Every reviewer comment addressed point-by-point, quoted, with a located change
- [ ] Each theoretical ask answered with a *theory* change (derivation/simulation/scope), not just wording
- [ ] Disagreements backed by derivation or diagnostic comparison, never bare assertion
- [ ] Concessions folded into boundary conditions rather than over-reaching
- [ ] Conflicting reviewer demands surfaced for the editor with a principled resolution
- [ ] A summary of the main strengthening opens the document
- [ ] Revised manuscript marked (track changes) and consistent with the response
## 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`](https://github.com/brycewang-stanford/Awesome-Journal-Skills) → `Psychological-Review-Skills/skills/psychrev-rebuttal/SKILL.md`