mcpField
R
rebuttal-and-response-to-reviewers

rebuttal-and-response-to-reviewers

github.com/kalarislabsDocuments7354 installsUpdated 3d ago
Repository

About rebuttal-and-response-to-reviewers

A writing skill for academic authors preparing reviewer responses. It structures comment triage, revision work, and evidence-linked replies for both journal letters and conference rebuttals.

Key features

  1. 01Break comments into atomic items
  2. 02Prioritize by impact and feasibility
  3. 03Link replies to evidence and locations
  4. 04Structure journal and conference responses
  5. 05Check completeness, accuracy, and length

Use cases

  1. 01Organizing feedback from multiple reviewers
  2. 02Preparing a conference rebuttal
  3. 03Writing a journal revision letter

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/kalarislabs/research-agent-skills --skill rebuttal-and-response-to-reviewers

After installing, type/rebuttal-and-response-to-reviewersin Claude Code to confirm it loaded.

Details

From the project README

Responding to Reviewers

The audience of a response is the editor or area chair, who must decide quickly whether concerns were addressed. Make every reply easy to verify: quote the concern, answer it directly, show the change with a location.

Step 1: Triage (before writing anything)

Split every review into atomic comments and classify each in a table:

IDReviewerComment (short)TypeEffortPlan
R1.11Missing baseline XExperimentHighRun X on 2 datasets
R2.32Claim in §4 overstatedWordingLowSoften + add limitation

Types: misunderstanding (the text was unclear), missing analysis/experiment, wording/presentation, disagreement on substance, out of scope, factual error by reviewer.

Then:

  • Identify the 2-3 concerns that drive the scores (often shared across reviewers). These get the most effort and appear first in a conference rebuttal.
  • Decide what is feasible in the revision window. Never promise experiments you will not run.
  • Note conflicts between reviewers so the editor can adjudicate.

Step 2: Do the work, then write

Run the experiments and edit the manuscript before drafting replies, so every reply can point to a concrete change. Keep a change log with section/page/line numbers.

Step 3: Reply patterns

Journal response letter (no strict length):

Reviewer 1, Comment 1: "<quote or faithful summary of the concern>"

Response: We thank the reviewer for ... [direct answer in the first sentence].
We have [action]. The new results (Table 3, p. 7, lines 210-224) show ...

Change in manuscript: "<quoted new/revised text>" (Section 4.2, p. 7)

Best practices:

  • Answer in the first sentence ("Yes, we have added...", "We agree and have...", "We respectfully disagree because...").
  • Thanks once per reviewer, not before every comment.
  • Quote revised text so the reviewer need not hunt for it. Provide a tracked-changes/diff version if the journal allows.
  • Number comments (R1.1, R1.2 ...) and cross-reference instead of repeating ("see our response to R2.1").

Disagreeing (it is allowed and expected when justified):

  1. Acknowledge the underlying concern ("We understand the concern that ...").
  2. Give evidence: data, citations, a small additional analysis, or a precise explanation.
  3. Make a concession where honest: a clarification in the text or a stated limitation. Never be sarcastic, never say the reviewer "failed to understand". Rewrite the text so the next reader won't.

Conference rebuttal (hard limits: characters/words per reviewer or one page; check the venue):

  • Lead with a short general response covering shared concerns and new results.
  • Then per reviewer, only the comments that affect the decision, 2-5 sentences each.
  • Put new numbers in compact tables. State exactly what will change in the camera-ready.
  • Correct factual misreadings politely with pointers ("Section 3.2, Eq. 4 defines ...").
  • Respect the venue's rules on new experiments, links and supplementary material. Many prohibit external links or new PDFs during rebuttal.
  • On OpenReview discussions: reply promptly and concisely, and summarize the resolved points for the AC near the end.

Step 4: Cover note to the editor (journals)

Summarize the main changes in 3-6 bullets, flag any reviewer disagreements you could not resolve and why, and confirm all co-authors approved the revision.

Quality checklist

  • Every comment has a response. Count them against the triage table.
  • Every "we have added/changed" is actually in the manuscript at the cited location.
  • New numbers match between response, manuscript, tables and abstract.
  • Tone: professional, specific, never defensive. Read it as the reviewer would.
  • No new claims beyond what the revised evidence supports.
  • Length within the venue limit (count it).

Related skills

peer-review (reviewing others' work: useful to anticipate criticism), scientific-writing, ml-paper-writing, scientific-critical-thinking, statistical-analysis.

Comments

Markdown supported