Skip to main content
Writing & LiteratureAcademic Writing102 lines

Peer Review

Guides both writing and responding to peer reviews of academic manuscripts.

Quick Summary18 lines
Peer review is the quality control mechanism of academic publishing. As a reviewer, your job is to improve the manuscript and advise the editor. As an author, your job is to engage with feedback constructively and demonstrate that every concern has been addressed.

## Key Points

1. **Contribution**: Does this advance the field in a meaningful way?
2. **Validity**: Are the methods sound and the conclusions supported by the evidence?
3. **Completeness**: Are there missing analyses, references, or explanations?
4. **Clarity**: Is the writing clear and well-organized?
5. **Presentation**: Are figures effective, formatting correct, and grammar clean?
- **Accepted changes**: implemented as suggested, with brief acknowledgment
- **Modified changes**: partially implemented with explanation of your reasoning
- **Respectful disagreements**: declined with evidence-based justification
1. Read the manuscript once without taking notes to understand the full argument
2. Re-read with the evaluation hierarchy in mind, annotating specific issues
3. Summarize the paper's contribution in two to three sentences to confirm understanding
4. List major concerns that affect the validity or significance of the work
skilldb get academic-writing-skills/Peer ReviewFull skill: 102 lines
Paste into your CLAUDE.md or agent config

Peer Review Process

Overview

Peer review is the quality control mechanism of academic publishing. As a reviewer, your job is to improve the manuscript and advise the editor. As an author, your job is to engage with feedback constructively and demonstrate that every concern has been addressed.

This skill covers both sides: writing constructive, thorough reviews and crafting effective responses to reviewer comments. It applies to journal manuscripts, conference papers, and internal review processes.

Core Philosophy

Peer review is an act of professional service, not an exercise of power. As a reviewer, your job is to improve the manuscript and advise the editor -- not to demonstrate your own expertise, settle intellectual scores, or block work that competes with your own. The best reviews are thorough, constructive, and respectful, treating the author as a colleague who deserves the same quality of feedback you would want on your own work.

As an author, reviewer comments are data about how your paper reads, not personal attacks. The emotional sting of criticism is real but must be separated from the substantive content of the feedback. A reviewer who misunderstood your argument is telling you that the argument was unclear, even if they are wrong about what they think it should say. Engage with every comment, implement what strengthens the paper, and decline what does not with evidence-based reasoning rather than defensiveness.

Timeliness and completeness are ethical obligations. Accepting a review and then delivering it months late -- or superficially -- wastes the author's time and damages the system that every academic depends on. If you cannot complete a review within the agreed timeframe, decline promptly so the editor can find someone who can.

Anti-Patterns

  • Writing vague reviews that cannot be acted upon. "The methodology needs improvement" is not useful feedback. Specify which aspect of the methodology is problematic, why it matters, and what would strengthen it. The author needs to know exactly what to change, not just that something is wrong.

  • Requesting entirely new experiments or analyses outside the paper's scope. A review should assess whether the paper accomplishes what it sets out to do, not whether it does something the reviewer wishes it did. Suggesting complementary analyses is reasonable; demanding a fundamentally different study is not, and it signals that the reviewer is evaluating the paper they wanted to read rather than the one submitted.

  • Becoming defensive rather than engaging with critique. As an author, writing a response letter that dismisses reviewer concerns or argues that the reviewers are wrong without evidence alienates the editor and wastes a revision opportunity. Even when you disagree, engage substantively and show that you took the concern seriously.

  • Ignoring minor comments in the revision. Minor comments about typos, unclear phrasing, or formatting may seem trivial, but ignoring them signals carelessness to the editor. Address every point, however small, to demonstrate thoroughness and respect for the review process.

  • Submitting a response letter without making the corresponding changes in the manuscript. Claiming to have addressed a concern in the response letter while leaving the manuscript unchanged is immediately apparent to reviewers and editors. Every change described in the response must be verifiable in the revised text, with specific page and line numbers.

Core Framework

The Reviewer's Evaluation Hierarchy

Assess manuscripts in this order, from most to least fundamental:

  1. Contribution: Does this advance the field in a meaningful way?
  2. Validity: Are the methods sound and the conclusions supported by the evidence?
  3. Completeness: Are there missing analyses, references, or explanations?
  4. Clarity: Is the writing clear and well-organized?
  5. Presentation: Are figures effective, formatting correct, and grammar clean?

The Response Strategy (For Authors)

Organize your revision around three categories:

  • Accepted changes: implemented as suggested, with brief acknowledgment
  • Modified changes: partially implemented with explanation of your reasoning
  • Respectful disagreements: declined with evidence-based justification

Never ignore a comment. Every point must receive a visible response.

Process

Writing a Review

  1. Read the manuscript once without taking notes to understand the full argument
  2. Re-read with the evaluation hierarchy in mind, annotating specific issues
  3. Summarize the paper's contribution in two to three sentences to confirm understanding
  4. List major concerns that affect the validity or significance of the work
  5. List minor concerns related to clarity, presentation, or missing details
  6. Provide specific, actionable suggestions rather than vague criticism
  7. Note strengths explicitly to maintain a balanced and constructive tone
  8. Draft a confidential recommendation to the editor with clear justification

Responding to Reviews

  1. Read all reviews completely before reacting emotionally
  2. Create a response table mapping each comment to an action
  3. Address major concerns first with substantive revisions
  4. Revise the manuscript, tracking changes or highlighting modified text
  5. Write a point-by-point response letter quoting each reviewer comment and your reply
  6. Include page and line numbers referencing where changes appear in the revised manuscript

Key Principles

  • Critique the work, never the author; maintain professional respect throughout
  • Be specific: cite page numbers, equations, or figure numbers when identifying issues
  • Distinguish between essential revisions and suggestions for improvement
  • Recommend rejection only when fundamental flaws cannot be fixed by revision
  • As an author, treat reviews as data about how your paper reads, not personal attacks
  • Revisions that exceed what reviewers asked for signal seriousness and thoroughness
  • Timeliness matters; complete reviews within the agreed deadline

Common Pitfalls

  • Writing reviews that are vague ("the writing needs improvement" with no specifics)
  • Requesting entirely new experiments that are outside the paper's scope
  • As an author, becoming defensive rather than engaging with the substance of critiques
  • Ignoring minor comments, which signals carelessness to the editor
  • Submitting a response letter without actually making the corresponding changes
  • Assuming a single round of revision will always be sufficient

Output Format

For reviews, deliver:

  1. Summary: 2-3 sentences describing the paper's aim and contribution
  2. Major comments: numbered list of substantive concerns with specific references
  3. Minor comments: numbered list of presentation and clarity issues
  4. Recommendation: accept, minor revision, major revision, or reject with rationale

For revision responses, deliver:

  1. Cover letter: brief summary of key changes made
  2. Point-by-point response: each reviewer comment quoted, followed by your response and location of changes
  3. Revised manuscript: with changes tracked or highlighted

Install this skill directly: skilldb add academic-writing-skills

Get CLI access →