skills/43-wentorai-research-plugins/skills/research/paper-review/review-response-guide/SKILL.md
Craft effective point-by-point reviewer response letters
npx skillsauth add brycewang-stanford/Awesome-Agent-Skills-for-Empirical-Research review-response-guideInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
A skill for crafting effective, professional point-by-point response letters to peer reviewer comments. Covers response letter structure, strategies for different types of reviewer feedback, prioritization of revisions, managing conflicting reviewer opinions, and navigating the revision-resubmission cycle to maximize acceptance probability.
A well-organized response letter follows a consistent structure that makes it easy for editors and reviewers to verify that all concerns have been addressed.
Response Letter Structure:
1. COVER LETTER TO EDITOR (1 page max)
- Thank the editor and reviewers
- Summarize the 3-5 most significant changes
- Highlight any points where you respectfully disagree
- Note if conflicting reviewer requests required a judgment call
- State that all changes are marked in the revised manuscript
2. SUMMARY OF CHANGES (optional but recommended)
- Bulleted list of all major changes
- Brief enough to read in 2 minutes
- Organized by theme, not by reviewer
3. POINT-BY-POINT RESPONSES
For each reviewer, for each comment:
---
REVIEWER [N], Comment [M]:
[Quote the reviewer's comment verbatim, italicized]
RESPONSE:
[Your substantive response]
CHANGES MADE:
[Exact description of what changed, with page/line numbers
or quoted text from the revised manuscript]
---
4. ADDITIONAL CHANGES (if any)
- Changes you made that were not requested by reviewers
- Example: "We also updated Figure 3 to use colorblind-
friendly colors throughout."
Visual formatting for clarity:
1. Use consistent fonts:
- Reviewer comments: italic
- Your responses: regular weight
- Changes made: indented or in a different color
2. Numbering system:
- R1.1, R1.2, R1.3 for Reviewer 1's comments
- R2.1, R2.2 for Reviewer 2's comments
- Major comments first, then minor comments
3. Cross-references:
- When one response addresses multiple comments:
"See our response to R1.3 above, which also addresses
this concern."
- When changes span multiple sections:
"See revised manuscript, pp. 8-9, paragraphs 2-3
(marked in blue)."
4. Length calibration:
- Major comments: 100-300 words per response
- Minor comments: 20-50 words per response
- Total response letter: typically 5-20 pages
- Longer is fine if substantive; never pad with fluff
When reviewers question your methodology:
Scenario: "The sample size is too small for the claims made."
Strong response structure:
1. Acknowledge the concern explicitly
2. Provide quantitative justification (power analysis)
3. Add additional analysis if possible
4. Acknowledge remaining limitations honestly
Example:
"We appreciate this important concern about statistical power.
We have now added a formal power analysis (Supplementary
Section S2) showing that our sample of N=120 provides 82%
power to detect the medium effect size (d=0.5) that our
hypotheses predicted, based on prior work by Chen et al.
(2021). Our observed effects were larger than this threshold
(d=0.72, 95% CI [0.41, 1.03]). We have also added a
sensitivity analysis (new Table S3) confirming that results
are robust to different analytical choices. We acknowledge
the power limitation for detecting small effects and have
added this to the Limitations section (p. 18, lines 4-8)."
When reviewers ask for more analysis:
If feasible - do it:
"We thank the reviewer for this excellent suggestion.
We have conducted the requested analysis and present
the results in new Table 4 (p. 12). The findings are
consistent with our main results, strengthening our
conclusions."
If partially feasible - do what you can:
"We have conducted [part A] of the suggested analysis
(new Figure S5). Unfortunately, [part B] is not possible
with our current dataset because [specific reason].
We have added this as a direction for future research
(p. 19, line 12)."
If not feasible - explain clearly:
"This analysis would require [data/resource] that is not
available in our study because [reason]. However, we have
conducted [alternative analysis] that addresses the
underlying concern. We also now discuss this limitation
explicitly (p. 17)."
When Reviewer 1 and Reviewer 2 disagree:
This happens frequently. The key is to:
1. Acknowledge both perspectives
2. Explain your reasoning transparently
3. Ask the editor to adjudicate if needed
Example:
"Reviewer 1 suggests removing the qualitative analysis
(R1.4), while Reviewer 2 asks us to expand it (R2.7).
We believe the qualitative component adds important
context to our quantitative findings, consistent with
mixed-methods best practices (Creswell, 2018). We have
therefore retained the qualitative analysis but tightened
it from 4 pages to 2 pages, focusing on the most
illustrative quotes. We respectfully ask the editor to
advise if further adjustment is needed."
In the cover letter:
"We note a point of divergence between Reviewers 1 and 2
regarding the qualitative analysis (R1.4 vs R2.7). We have
described our proposed compromise in the detailed responses
and welcome the editor's guidance on this matter."
Strategy: Correct respectfully, blame your own writing
Never: "The reviewer is incorrect about..."
Never: "The reviewer failed to understand..."
Never: "As any expert in this field would know..."
Instead:
"We appreciate this comment, which indicates that our
description of [topic] was not sufficiently clear. We have
rewritten Section 3.2 (pp. 9-10) to clarify that [correct
information]. The key point, which we now state explicitly
in the second paragraph, is that [clarification]. We hope
the revised text prevents this misunderstanding."
Why this works:
- Acknowledges the reviewer's effort
- Takes responsibility for the miscommunication
- Improves the paper for future readers who might have
the same misunderstanding
- Corrects the record without antagonizing the reviewer
Strategy: Maintain professionalism, address substance
If a comment is dismissive without substance:
Reviewer: "This paper is not interesting."
Response: "We have revised the Introduction to more
clearly articulate the significance of our research
question and its implications for [field]. Specifically,
we now explain [relevance point 1], [relevance point 2],
and [relevance point 3] (pp. 2-3)."
If a comment reveals the reviewer did not read the paper:
Reviewer: "The authors did not control for age."
Response: "We appreciate this concern. Age was included
as a covariate in all models, as described in Section 3.4
(p. 11, line 3) and reported in Table 2, Column 3. We have
added bold formatting to make this control variable more
visible in the table."
If appropriate, raise concerns with the editor:
In the cover letter (not the response):
"We note that Comment R2.5 appears to request an analysis
that is already reported in Table 4 of our manuscript.
We welcome the editor's assessment of whether our response
adequately addresses this concern."
Step-by-step revision workflow:
1. Cooling-off period (1-2 days):
Read reviews once, then set them aside.
Initial emotional reactions are normal.
2. Comment triage (1 day):
Create a spreadsheet with columns:
- Reviewer, Comment number, Category, Difficulty, Action
Categories: major/minor, methodological/theoretical/editorial
Difficulty: easy/medium/hard
3. Easy wins first (1-2 days):
Address minor comments: typos, formatting, missing references
These require minimal thought and build momentum
4. Hard problems (1-2 weeks):
Address major methodological and theoretical concerns
Run additional analyses
Rewrite substantial sections
Consult co-authors on strategy
5. Response letter drafting (2-3 days):
Write point-by-point responses
Include specific page/line numbers for all changes
6. Co-author review (3-5 days):
All co-authors review the revised manuscript AND the
response letter before resubmission
7. Final checks (1 day):
Verify all page/line numbers are correct
Check that tracked changes match response descriptions
Ensure formatting meets journal requirements
Timeline: Allow 4-8 weeks for a major revision
Deadline: Most journals give 60-90 days; request extension
if needed (editors almost always grant it)
A well-crafted response letter demonstrates intellectual maturity, thoroughness, and respect for the peer review process. The strongest response letters share a common trait: they treat every reviewer comment as an opportunity to improve the paper, even when the reviewer is wrong, because the revision process ultimately serves the reader.
development
Conduct rigorous thematic analysis (TA) of qualitative data following Braun and Clarke's (2006) six-phase framework. Use whenever the user mentions 'thematic analysis', 'TA', 'Braun and Clarke', 'qualitative coding', 'identifying themes', or asks for help analysing interviews, focus groups, open-ended survey responses, or transcripts to identify patterns. Also trigger for questions about inductive vs theoretical coding, semantic vs latent themes, essentialist vs constructionist epistemology, building a thematic map, or writing up a qualitative findings section. Covers all six phases, the four upfront analytic decisions, the 15-point quality checklist, and the five common pitfalls. Produces a Word document write-up and an annotated thematic map. Does NOT cover IPA, grounded theory, discourse analysis, conversation analysis, or narrative analysis — use a different method for those.
development
Guide users through writing a systematic literature review (SLR) following the PRISMA 2020 framework. Use this skill whenever the user mentions 'systematic review', 'systematic literature review', 'SLR', 'PRISMA', 'PRISMA 2020', 'PRISMA flow diagram', 'PRISMA checklist', or asks for help writing, structuring, or auditing a literature review that follows reporting guidelines. Also trigger when the user asks about inclusion/exclusion criteria for a review, search strategies for databases like Scopus/WoS/PubMed, study selection processes, risk of bias assessment, or narrative synthesis for a review paper. This skill covers the full PRISMA 2020 checklist (27 items), produces a Word document manuscript in strict journal article format, generates an annotated PRISMA flow diagram, and enforces APA 7th Edition referencing throughout. It does NOT cover meta-analysis or statistical pooling. By Chuah Kee Man.
testing
Performs placebo-in-time sensitivity analysis with hierarchical null model and optional Bayesian assurance. Use when checking model robustness, verifying lack of pre-intervention effects, or estimating study power.
data-ai
Fit, summarize, plot, and interpret a chosen CausalPy experiment. Use after the causal method has been selected, including when configuring PyMC/sklearn models and scale-aware custom priors.