15.26Academic University ResearchPublishingAvailable

Peer Review Response

Sort reviewer comments, answer every one with a location, disagree professionally, and decide whether to revise, appeal or withdraw.

Free. Works on Claude, ChatGPT, Gemini or any assistant that accepts a skill file.

What this skill does

The method, encoded.

Confidentiality first. A manuscript under review is confidential, and many publishers now prohibit entering one into an AI system, treating it as a breach of reviewer confidentiality. This skill is built for an author responding to reviews of their own work. A reviewer must check their publisher's policy before using any part of it, and should treat silence in that policy as prohibition. The skill does not write reviews.

For authors, responding to review is a professional skill almost nobody is taught, and it fails in predictable ways: replying within 48 hours while the emotional reaction is still driving the sentences, treating every comment as an order, treating every comment as an attack, missing the second and third requests buried in a single paragraph, and writing a response an editor cannot adjudicate because it never says what changed or where.

This skill supplies the process. Read once, wait, read again. Sort every discrete request into what must change, what should change, what is a misunderstanding to clarify, and what is a disagreement to defend. Build a response document that quotes each comment, answers it, and names the exact location of the change. Disagree substantively, because a well-argued disagreement is normal and is often accepted, and because early-career authors concede far more than they need to. Put contradictions between reviewers to the editor rather than trying to satisfy both. Recognise the review that is really asking for a different paper. Then verify that every promise in the response actually exists in the manuscript.

Best used for

  • Building a response document for a major or minor revision
  • Deciding which reviewer requests to accept, negotiate or decline
  • Handling reviewers who ask for opposite things
  • Responding where a reviewer has misread the paper
  • Disagreeing with a reviewer professionally and successfully
  • Recognising and answering scope creep in revision requests
  • Deciding whether to appeal a rejection or submit elsewhere

Typical inputs

What you give it.

The editor's decision letter, The full reviewer reports, The manuscript as submitted, The venue's revision guidance and AI use policy, Optional co-author reactions collected before drafting, Optional data, code and analysis files for costing requested work, Optional prior reviews of the same paper at another venue

Typical outputs

What you get back.

Comment inventory with one row per discrete request, Four-way sort (must change, should change, misunderstanding, disagreement), Response document with verbatim comment, response and location for every point, Contradiction register putting conflicting reviewer requests to the editor, Costed workload estimate for all accepted requests, Revise, appeal or withdraw decision with recorded reasoning, Verification record confirming every promised change exists in the manuscript

Method coverage

What the skill works through.

  1. Confidentiality: why a manuscript under review must not be entered into an AI system
  2. Read once, wait, read again
  3. Breaking reviews into discrete requests
  4. The four-way sort: must, should, misunderstanding, disagreement
  5. The response document structure editors need
  6. Why every response must name a location
  7. Answering a reviewer who misread the paper
  8. How to disagree with a reviewer and be taken seriously
  9. Contradictory reviewers and the editor's role
  10. The review that asks for a different paper
  11. Costing scope creep before agreeing to it
  12. Revise, appeal or withdraw
  13. Checking the manuscript against your own promises
  14. The ethics of being a reviewer

Download

Free skill. One file.

Enter your email once. Every skill you download after that takes a single click.

How to install

Add the skill file and the five kernel protocols to a Claude Project, a ChatGPT Project, a Gemini Gem, or paste them at the top of any assistant conversation. Then give it your real research material, not a description of it.

Download skill

Questions

Common questions.

Can I use AI to help respond to peer review?

As an author working on your own manuscript and your own reviews, usually yes, subject to your venue's AI disclosure policy, which you should check and comply with. As a reviewer, usually no: a manuscript under review is confidential, and many publishers prohibit entering it into an AI system entirely. Where a publisher's policy is silent, treat it as prohibited, because the confidentiality obligation exists independently of any rule about a specific technology.

How do I write a response to reviewers?

Address every comment, in the order the reviewer made them, with three elements each: the reviewer's comment quoted in full, your response saying what you did or why you did not, and the exact location of the change in the revised manuscript. The location is the element authors omit and editors most need. Open with a short covering note flagging any request you have not complied with, so the editor is not surprised by it later.

Can I disagree with a reviewer?

Yes, and a well-argued disagreement is a normal part of review and is frequently accepted. Acknowledge the point properly, give substantive reasons (evidence, method, literature, scope), name what would be lost by doing it the reviewer's way, and offer something in return. Most disagreements resolve by narrowing the claim rather than defending it whole.

What do I do when a reviewer misunderstood my paper?

Change the text, and do not tell them they misread it. A competent specialist reading carefully enough to write a review took a different meaning from your passage, which means ordinary readers will too. Acknowledge that the point was not clear, state what the paper intends, and name the specific change you made. Never answer with "as stated on page 6".

What if two reviewers want opposite things?

Name the contradiction explicitly in your response, quote both comments, explain the trade, say which you followed and why in terms of the paper's contribution, address the other reviewer's underlying concern by another route if you can, and ask the editor to adjudicate. That is their role. Trying to satisfy both produces an incoherent paper that fails both.

A reviewer is asking for a whole extra study. Do I have to do it?

Test it: could you meet the request with the data, access and time you have, and does the paper's claim actually require it? If the claim does not require it, this is scope expansion. State the paper's scope, add the limitation the point implies, and identify the request as future work. Cost the requests in aggregate, because five individually reasonable additions can amount to a second paper.

Should I appeal a journal rejection?

Rarely. Appeals are appropriate where a review contains a factual error that was material to the decision, where a reviewer had an evident conflict, or where the decision rests on a checkable misreading. They are not appropriate because the decision was harsh. They take months, they rarely succeed, and a failed appeal costs your relationship with the venue. In most cases, revise using the reviews and submit elsewhere.

How long should I wait before responding to reviews?

At least two days between the first reading and any drafting. This is a method step rather than self-care: the first reading is dominated by threat response, attention narrows to the harshest sentences, and responses drafted in that state are defensive where they should concede and conceding where they should defend.

Does a rejection still tell me anything useful?

Yes, and it is the part most often wasted. Run the same sort on the reviews, execute the must-changes and most of the should-changes, and only then choose the next venue. If two independent sets of reviewers at different venues make the same criticism, that is evidence about the paper, not about the reviewers.

Research where people already are.
Analyse it where you already work.

Yazi helps researchers conduct surveys, AI interviews and longitudinal research directly through WhatsApp.

New Report on SA Gambling Impact
Check It Out