Skip to content
cccskills
FreePublished on GitHub

referee-response

Draft and organize response letters for revised journal submissions. Address each editor and referee comment, link responses to manuscript changes, explain disagreements with evidence, and check that every comment has been covered.

OriginalShow the original description

Structure responses to referee reports for R&R submissions

See how to install

Good for

  • Preparing a response letter for a revised submission
  • Drafting responses to individual referee comments
  • Explaining evidence-based disagreements politely
  • Checking response coverage and summarizing changes

Files included (1)

  • SKILL.md5.8 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Referee Response Assistant

Help structure and draft responses to referee reports. Ensures consistent formatting and comprehensive responses.


Response Document Structure

RESPONSE TO REFEREE COMMENTS

Paper: [Title]
Authors: [Names]
Journal: [Journal Name]
Manuscript #: [Number]
Date: [Date]

We thank the editor and referees for their constructive comments.
We have carefully addressed all points raised. Below we provide
point-by-point responses. Referee comments are in italics, and
our responses follow in regular text. All page and line numbers
refer to the revised manuscript.

================================================================
RESPONSE TO EDITOR
================================================================

[Editor comments and responses]

================================================================
RESPONSE TO REFEREE 1
================================================================

[Point-by-point responses]

================================================================
RESPONSE TO REFEREE 2
================================================================

[Point-by-point responses]

Point-by-Point Response Template

For each referee comment:

----------------------------------------------------------------
Comment 1.X: [Brief label for reference]
----------------------------------------------------------------

*[Paste exact referee comment in italics]*

RESPONSE:

[Your response here]

- What we did to address the comment
- Where changes appear in the manuscript (page X, lines Y-Z)
- If we added analysis, summarize the results
- If we respectfully disagree, explain why with evidence

CHANGES MADE:
- Page X: [Description of change]
- Table Y: [Description of new/modified table]
- Section Z: [Description of new text]

Response Strategies by Comment Type

Data/Sample Questions

The referee raises an important point about [issue]. We have:
1. [Addressed concern directly]
2. Added robustness tests in Table X showing results hold when [alternative]
3. Discussed this limitation on page Y, lines Z

Identification Concerns

We appreciate this comment on identification. We address this in three ways:
1. Added [placebo test/IV/etc.] in Table X
2. Discussed the assumption more carefully in Section Y
3. Acknowledge remaining limitations on page Z

Requests for Additional Analysis

Thank you for this suggestion. We have added [analysis] in Table X / Figure Y.
The results show [brief summary]. This [strengthens/qualifies] our main findings.

Clarification Requests

We apologize for the lack of clarity. We have revised the text on page X
to clarify that [explanation]. The revised passage now reads:

"[Quote revised text]"

Disagreement (Respectful)

We appreciate this thoughtful comment. After careful consideration, we
respectfully maintain our original approach because:
1. [Reason 1 with evidence/citation]
2. [Reason 2]

However, we have added discussion of this alternative perspective on page X
and include [robustness test] in the appendix to address related concerns.

Change Tracking Summary

Include at the end of your response:

================================================================
SUMMARY OF MAJOR CHANGES
================================================================

1. Added Table X: [Description]
2. Added Figure Y: [Description]
3. Revised Section Z to [description]
4. Added robustness tests for [list]
5. Expanded discussion of [topic] on pages A-B

================================================================
SUPPLEMENTARY MATERIALS ADDED
================================================================

- Online Appendix Table A1: [Description]
- Online Appendix Figure A1: [Description]
- Replication package updated with [additions]

Quick Commands

  • "format referee response" - Set up response document structure
  • "respond to this comment" - Draft response to a specific comment
  • "disagreement response" - Help phrase respectful disagreement
  • "summarize changes" - Generate changes summary from our edits
  • "check completeness" - Verify all comments addressed

Tone Guidelines

Do:

  • Thank referees for specific insights
  • Be concise but thorough
  • Clearly indicate where changes were made
  • Acknowledge valid limitations
  • Cite supporting evidence for your choices

Don't:

  • Be defensive or dismissive
  • Ignore parts of comments
  • Over-explain obvious points
  • Promise future work instead of doing it now
  • Leave any comment unaddressed

Common Phrases

Agreeing:

  • "We thank the referee for this excellent suggestion."
  • "This is an important point that strengthens our analysis."
  • "We have incorporated this suggestion as follows..."

Partial agreement:

  • "We appreciate this comment. While [X], we have [Y]."
  • "This is a valid concern. We address it by..."

Respectful disagreement:

  • "We thank the referee for raising this issue. After careful consideration..."
  • "We respectfully maintain our approach because..."
  • "While we see the merit in this suggestion, we believe..."

Acknowledging limitations:

  • "We acknowledge this limitation and have added discussion on page X."
  • "While ideal data would allow [X], our approach is consistent with [citations]."

Pre-Submission Checklist

Before submitting your response:

  • Every comment has a response (numbered consistently)
  • All page/line references are accurate for revised manuscript
  • New tables/figures are referenced correctly
  • Track changes document is prepared
  • Clean version of manuscript is prepared
  • Supplementary materials are updated
  • Cover letter to editor is drafted
  • Co-authors have reviewed responses

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

a1

FreeSummary

Turn a broad research idea into clear, testable questions. Compare familiar and less conventional approaches, structure the selected question around its population and methods, and assess variables, feasibility, and potential theoretical contributions.

  • Turn a research topic into testable questions
  • Narrow an overly broad research question
  • Compare alternative research angles
brycewang-stanford/Auto-Empirical-Research-Skills4.7KUpdated Oct 20, 2026

a2

FreeSummary

Helps build a research framework by comparing theories, mapping relationships between variables, and deriving testable hypotheses. Explores less conventional options, examines weaknesses and competing explanations, and produces diagrams with anticipated reviewer objections.

  • Comparing theories for a research question
  • Deriving hypotheses from relationships between variables
  • Examining weaknesses and anticipated reviewer objections
brycewang-stanford/Auto-Empirical-Research-Skills4.7KUpdated Oct 20, 2026

a5

FreeSummary

Clarify the philosophical assumptions behind a research project and check whether they fit the proposed methods. Get a reasoned research stance, draft proposal wording, and guidance for explaining how the researcher's background and values shape the study.

  • Clarifying philosophical foundations for a research proposal
  • Explaining why the chosen research methods fit the study
  • Drafting a statement about the researcher's position
brycewang-stanford/Auto-Empirical-Research-Skills4.7KUpdated Oct 20, 2026

academic-paper

FreeSummary

Plan and draft academic papers through specialized agent roles covering literature, arguments, citations, and review. Get chapter guidance, revision roadmaps, Traditional Chinese and English abstracts, and documents formatted as LaTeX, DOCX, PDF, or Markdown.

  • Planning a paper chapter by chapter
  • Drafting a paper from research materials
  • Turning reviewer comments into a revision roadmap
brycewang-stanford/Auto-Empirical-Research-Skills4.7KUpdated Oct 20, 2026

Turn a detailed outline into a philosophy or interdisciplinary manuscript. Draft chapters with repeated quality reviews, check terminology and arguments across sections, and prepare the manuscript, evaluation reports, abstract, and metadata for submission.

  • Draft a full paper from a detailed outline
  • Review argument and citation quality chapter by chapter
  • Check terminology and argument flow across chapters
brycewang-stanford/Auto-Empirical-Research-Skills4.7KUpdated Oct 20, 2026

Simulate academic peer review through five reviewer roles tailored to the paper's field. Receive separate critiques, an editorial decision, and a prioritized revision roadmap, or check whether a revised manuscript addresses earlier comments.

  • Review a manuscript before journal submission
  • Examine research methods and statistical validity
  • Challenge core arguments and alternative explanations
brycewang-stanford/Auto-Empirical-Research-Skills4.7KUpdated Oct 20, 2026

See all skills by brycewang-stanford

Report a problem with this skill