Skip to content
cccskills
FreePublished on GitHub

review-response

Turn reviewer comments into a structured response document. The skill classifies concerns, suggests whether to revise, defend, clarify, or experiment, and drafts evidence-based replies while checking completeness, professional tone, and respectful wording.

OriginalShow the original description

Systematic review response workflow from comment analysis to professional rebuttal writing. Use when the user asks to "write rebuttal", "respond to reviewers", "draft review response", or "analyze review comments". Improves paper acceptance rates.

Run score Not tested

See how to install

Good for

  • Classifying reviewer comments by issue type
  • Planning revisions and additional experiments
  • Drafting responses to every reviewer comment
  • Checking the tone of a rebuttal

Files included (6)

  • SKILL.md5.0 KB
  • references/rebuttal-templates.md16.9 KB
  • references/response-strategies.md18.8 KB
  • references/review-classification.md3.4 KB
  • references/successful-cases.md10.5 KB
  • references/tone-guidelines.md9.6 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Review Response

A systematic review response workflow that helps researchers efficiently and professionally reply to reviewer comments.

Core Features

  1. Review Analysis - Parse and classify reviewer comments (Major/Minor/Typo/Misunderstanding)
  2. Response Strategy - Develop response strategies for different comment types (Accept/Defend/Clarify/Experiment)
  3. Rebuttal Writing - Write structured, professional rebuttal documents
  4. Tone Management - Optimize tone to maintain professionalism, respect, and evidence-based arguments

Workflow

Receive reviewer comments -> Parse and classify -> Develop strategy -> Write responses -> Tone check -> Final rebuttal

When to Use

Use this skill when you need to:

  • "Help me write a rebuttal"
  • "How to respond to reviewer comments"
  • "Analyze these review comments"
  • "Develop a review response strategy"

Usage Steps

  1. Provide reviewer comments - Share the reviewer comments text or file with Claude
  2. Analysis and classification - Claude automatically parses and classifies the comments
  3. Strategy recommendations - Receive response strategy suggestions for each comment
  4. Write rebuttal - Generate a structured rebuttal document based on the strategy
  5. Optimize tone - Review and optimize the professionalism and politeness of responses

Core Principles

  • Professionalism - Maintain an academically professional tone and expression
  • Respectfulness - Respect the reviewers' opinions and time
  • Evidence-based - Support every response with sufficient reasoning and evidence
  • Completeness - Ensure all reviewer comments receive a response

Success Factors (Based on ICLR Spotlight Paper Analysis)

Key lessons extracted from successful rebuttal cases:

1. Acknowledge Strengths, Respond Positively to Criticism

  • Reviewers will first acknowledge the paper's strengths (novelty, impact, practical applicability)
  • Even spotlight papers receive constructive criticism
  • Strategy: Thank reviewers for acknowledged strengths first, then address criticism specifically

2. Provide Clarity and Intuitive Understanding

  • Even high-quality papers may have clarity issues
  • Need to provide intuition and detailed explanations for readers with different backgrounds
  • Strategy: Expand key sections, move technical details to appendix, add step-by-step walkthroughs

3. Thorough Justification of Experimental Setup

  • Need to justify experimental setup choices
  • Consider and discuss alternative metrics
  • Provide comprehensive experiments to support claims
  • Strategy: Add ablation studies, explain why specific experimental setups were chosen

4. Emphasis on Ethical Considerations

  • For research involving privacy, security, and other sensitive topics, ethical considerations are crucial
  • Reviewers pay special attention to ethical implications
  • Strategy: Proactively discuss ethical considerations, even if reviewers don't explicitly request it

5. Highlight Practical Application Value

  • Reviewers value practical applicability and scalability of methods
  • "Easily applicable" and "scalable" are important strengths
  • Strategy: Emphasize practical benefits and scalability in the rebuttal

Integration with paper-miner global writing memory

When the rebuttal task involves:

  • tone calibration,
  • rebuttal phrasing,
  • clarification language,
  • structuring multi-point responses,
  • or learning from strong prior paper/review writing,

read this file before drafting:

  • ~/.claude/skills/ml-paper-writing/references/knowledge/paper-miner-writing-memory.md

Default read order for rebuttal work

  1. reviewer comments and paper context
  2. paper-miner-writing-memory.md
  3. references/response-strategies.md
  4. references/rebuttal-templates.md
  5. references/tone-guidelines.md

Read narrowly:

  • start with How this helps our writing,
  • then inspect Reusable phrasing,
  • then inspect Venue-specific signals if the rebuttal is venue-sensitive,
  • use Writing patterns mined only when the response needs stronger rhetorical structure.

Do not quote the memory mechanically. Use it to improve structure, clarity, restraint, and professionalism.

Reference Documents

For detailed guides, refer to:

  • references/review-classification.md - Review comment classification criteria
  • references/response-strategies.md - Response strategy library
  • references/rebuttal-templates.md - Rebuttal templates and examples
  • references/tone-guidelines.md - Tone and expression guidelines

Related Tools

  • Agent: rebuttal-writer - Dedicated agent for rebuttal writing and optimization
  • Command: /rebuttal <review_file> - Quick-start the rebuttal workflow

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.8KUpdated 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.8KUpdated 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.8KUpdated 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.8KUpdated 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.8KUpdated 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.8KUpdated Oct 20, 2026

See all skills by brycewang-stanford

Report a problem with this skill