Revision & Response for a Perspective (ppsych-revision)
When to trigger
- A PoPS decision letter (major/minor revision, or reject-and-resubmit) arrived
- Reviewers flagged missing literatures, imbalance, mischaracterization, or "reads like a list"
- The editor asked to broaden, sharpen, or rebalance the argument, or to strengthen open science
- You need a point-by-point response for a perspective, not a primary paper
Categories of review feedback (and how to answer each)
PoPS revision asks cluster differently from primary-research asks. Triage every point into one bucket:
| Feedback type |
Typical phrasing |
Response move |
| Scope / superordinate message |
"this reads like a single study / one paradigm" |
sharpen the broad claim; show the cross-area payoff (ppsych-topic-selection) |
| Coverage gap |
"you omit the X literature / area Y" |
almost always concede and integrate — place it in the right framework cell; re-run saturation (ppsych-literature-synthesis) |
| Balance / fairness |
"this slights camp Z / over-cites the author / one-sided reform" |
steelman the slighted side; re-audit self-citation and reform calibration (ppsych-comprehensiveness-and-balance) |
| Appraisal accuracy |
"you mischaracterize study/finding W" |
correct precisely; reviewed authors often referee — fix exactly |
| Framework / argument |
"this is an annotated bibliography" |
strengthen or make explicit the spine (ppsych-organizing-framework); don't just reorder |
| Accessibility / provocation |
"a non-specialist can't follow §4" / "what's the take-home?" |
add intuition, define jargon, state the claim earlier (ppsych-writing-style) |
| Open science |
"deposit the coding data / preregister the protocol" |
deposit and cite; report the registration link (ppsych-transparency-and-reproducibility) |
Writing the response letter
- Point-by-point, quote-then-respond. Reproduce each comment, then state the change and where it lives (section/page/table).
- Coverage asks: concede and integrate. A missing literature is a real defect in a broad review; adding it strengthens the piece. The omitting author may be the referee who named it.
- Balance asks: show the steelman. Demonstrate the revised text states the other side at its strongest — and, for reform pieces, that criticized practices are steelmanned and claims are calibrated to evidence.
- Accuracy asks: fix exactly. Mischaracterizing a reviewed author who is your referee is the fastest route to a hostile second round; correct the wording precisely.
- Open-science asks: act, don't promise. Deposit the data/code and report the DOI/registration link in the letter; do not defer to acceptance.
- Disagree rarely and respectfully. If an ask would break the spine or bloat the piece beyond concision, explain the trade-off and propose an alternative, ideally pre-cleared with the editor.
- Track every addition's ripple. Adding a literature can shift the argument's center of gravity; after each integration re-check that the framework cells, the exhibits, and the balance audit still hold, and that the piece stays concise.
Checklist
Anti-patterns
- Defending an omission rather than adding the missing literature (a coverage gap is a real defect)
- Answering a balance complaint with assertions of fairness instead of revised, steelmanned text
- Dismissing or re-mischaracterizing a reviewed author who is likely your referee
- "Fixing" an annotated-bibliography critique by shuffling paragraphs without imposing a spine
- Promising open data/code "on acceptance" instead of depositing it now
- Bloating scope to satisfy every "also cover…" until the perspective loses its spine and concision
- Trying to satisfy two contradictory reviewers instead of asking the editor to adjudicate
Output format
【Triage】each comment bucketed (scope/coverage/balance/appraisal/framework/accessibility/open-science)? Y/N
【Coverage gaps】conceded + integrated into framework cells; saturation re-run? Y/N
【Balance】steelman shown in revised text; self-citation + reform calibration re-audited? Y/N
【Appraisal fixes】mischaracterizations corrected precisely? Y/N
【Framework asks】spine strengthened/made explicit (not reordered)? Y/N
【Accessibility】intuition added; claim stated earlier? Y/N
【Open science】deposits done + cited; registration link reported? Y/N · N/A
【Letter】point-by-point, quote-then-respond, with locations? Y/N
【Next step】→ ppsych-submission (re-submit the revised perspective)
Source: brycewang-stanford/Awesome-Journal-Skills → Perspectives-on-Psychological-Science-Skills/skills/ppsych-revision/SKILL.md
1---2name: ppsych-revision3description: Use when responding to a Perspectives on Psychological Science (PoPS) editor and reviewer decision letter — coverage gaps, balance/fairness complaints, framework/argument asks, accessibility, and open-science requests. Drafts the response and revision plan; it does not run the submission preflight (ppsych-submission) or redesign the spine from scratch (ppsych-organizing-framework).4---567# Revision & Response for a Perspective (ppsych-revision)89## When to trigger1011- A PoPS decision letter (major/minor revision, or reject-and-resubmit) arrived12- Reviewers flagged missing literatures, imbalance, mischaracterization, or "reads like a list"13- The editor asked to broaden, sharpen, or rebalance the argument, or to strengthen open science14- You need a point-by-point response for a perspective, not a primary paper1516## Categories of review feedback (and how to answer each)1718PoPS revision asks cluster differently from primary-research asks. Triage every point into one bucket:1920| Feedback type | Typical phrasing | Response move |21|---------------|------------------|---------------|22| **Scope / superordinate message** | "this reads like a single study / one paradigm" | sharpen the broad claim; show the cross-area payoff (`ppsych-topic-selection`) |23| **Coverage gap** | "you omit the X literature / area Y" | almost always *concede and integrate* — place it in the right framework cell; re-run saturation (`ppsych-literature-synthesis`) |24| **Balance / fairness** | "this slights camp Z / over-cites the author / one-sided reform" | steelman the slighted side; re-audit self-citation and reform calibration (`ppsych-comprehensiveness-and-balance`) |25| **Appraisal accuracy** | "you mischaracterize study/finding W" | correct precisely; reviewed authors often referee — fix exactly |26| **Framework / argument** | "this is an annotated bibliography" | strengthen or make explicit the spine (`ppsych-organizing-framework`); don't just reorder |27| **Accessibility / provocation** | "a non-specialist can't follow §4" / "what's the take-home?" | add intuition, define jargon, state the claim earlier (`ppsych-writing-style`) |28| **Open science** | "deposit the coding data / preregister the protocol" | deposit and cite; report the registration link (`ppsych-transparency-and-reproducibility`) |2930## Writing the response letter3132- **Point-by-point, quote-then-respond.** Reproduce each comment, then state the change and where it lives (section/page/table).33- **Coverage asks: concede and integrate.** A missing literature is a real defect in a broad review; adding it strengthens the piece. The omitting author may be the referee who named it.34- **Balance asks: show the steelman.** Demonstrate the revised text states the other side at its strongest — and, for reform pieces, that criticized practices are steelmanned and claims are calibrated to evidence.35- **Accuracy asks: fix exactly.** Mischaracterizing a reviewed author who is your referee is the fastest route to a hostile second round; correct the wording precisely.36- **Open-science asks: act, don't promise.** Deposit the data/code and report the DOI/registration link in the letter; do not defer to acceptance.37- **Disagree rarely and respectfully.** If an ask would break the spine or bloat the piece beyond concision, explain the trade-off and propose an alternative, ideally pre-cleared with the editor.38- **Track every addition's ripple.** Adding a literature can shift the argument's center of gravity; after each integration re-check that the framework cells, the exhibits, and the balance audit still hold, and that the piece stays concise.3940## Checklist4142- [ ] Every comment triaged into a bucket (scope / coverage / balance / appraisal / framework / accessibility / open-science)43- [ ] Coverage gaps conceded and integrated into the right framework cell; saturation re-run44- [ ] Balance complaints answered by demonstrable steelmanning + self-citation / reform-calibration re-audit45- [ ] Mischaracterizations corrected precisely (reviewed authors may be the referees)46- [ ] "Annotated bibliography" asks answered by a stronger/explicit spine, not reordering47- [ ] Accessibility fixes add intuition / define jargon / state the claim earlier48- [ ] Open-science asks acted on (deposited + cited + registration link), not promised49- [ ] Point-by-point letter: quote-then-respond, with section/page/table locations50- [ ] Comprehensiveness + balance + concision re-checked after all additions5152## Anti-patterns5354- Defending an omission rather than adding the missing literature (a coverage gap is a real defect)55- Answering a balance complaint with assertions of fairness instead of revised, steelmanned text56- Dismissing or re-mischaracterizing a reviewed author who is likely your referee57- "Fixing" an annotated-bibliography critique by shuffling paragraphs without imposing a spine58- Promising open data/code "on acceptance" instead of depositing it now59- Bloating scope to satisfy every "also cover…" until the perspective loses its spine and concision60- Trying to satisfy two contradictory reviewers instead of asking the editor to adjudicate6162## Output format6364```text65【Triage】each comment bucketed (scope/coverage/balance/appraisal/framework/accessibility/open-science)? Y/N66【Coverage gaps】conceded + integrated into framework cells; saturation re-run? Y/N67【Balance】steelman shown in revised text; self-citation + reform calibration re-audited? Y/N68【Appraisal fixes】mischaracterizations corrected precisely? Y/N69【Framework asks】spine strengthened/made explicit (not reordered)? Y/N70【Accessibility】intuition added; claim stated earlier? Y/N71【Open science】deposits done + cited; registration link reported? Y/N · N/A72【Letter】point-by-point, quote-then-respond, with locations? Y/N73【Next step】→ ppsych-submission (re-submit the revised perspective)74```7576---7778**Source:** [`brycewang-stanford/Awesome-Journal-Skills`](https://github.com/brycewang-stanford/Awesome-Journal-Skills) → `Perspectives-on-Psychological-Science-Skills/skills/ppsych-revision/SKILL.md`
thedixitjain