
paper-rebuttal
Guides writing effective rebuttals after receiving peer review feedback. Covers review diagnosis (score-driven color-coding), response strategy (champion identification, common-theme consolidation), tactical writing (18 rules), and counterintuitive rebuttal principles. Use when: user received reviewer scores/comments, needs to write a rebuttal or author response, wants to respond to specific criticism (e.g. 'limited novelty', 'missing baselines'), mentions 'rebuttal', 'reviewer comments', 'author response', or 'respond to reviewers'. Do NOT use for pre-submission self-review (use paper-review instead).
- Installs
- 443
- Last 24h
- —
- Trending rank
- —
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/evoscientist/evoskills --skill paper-rebuttal- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads paper-rebuttal automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
Paper Rebuttal
A systematic approach to writing rebuttals after receiving peer review feedback. The goal is not to defend every point — it's to move scores by addressing the concerns that actually drive them.
When to Use This Skill
- User received reviewer comments and needs to write a rebuttal
- User asks how to respond to specific reviewer criticism
- User wants to analyze reviews strategically before responding
- User mentions "rebuttal", "reviewer comments", "review feedback", "respond to reviewers"
For pre-submission self-review and catching weaknesses before they become reviewer complaints, use the
paper-reviewskill.
Step 1: Diagnose Reviews
Before writing a single word, answer: "Why did this reviewer give this exact score?" Not what they wrote — what drove the score. Most researchers skip this and address every comment equally. That is a mistake.
Score Diagnosis
For each reviewer, ask: "What would move this reviewer from their current score to acceptance?"
| Score Range | Typical Situation | Your Strategy |
|---|---|---|
| 7+ | Already your champion | Arm them with ammunition for the discussion phase |
| 5-6 | On the fence, 1-2 concerns holding them back | Identify and resolve those specific concerns |
| 3-4 | Fundamental objection | Determine if the objection is addressable; if not, focus elsewhere |
| 1-2 | Strong rejection | Identify the one or two objections that drive the score, not every point they raise |
Color-Code Every Comment
Read through each review and mark every comment:
| Color | Meaning | Action | Budget |
|---|---|---|---|
| Red | Score-driving concern — this is why the score is low | Address first, maximum effort and evidence | 60% |
| Orange | Addressable concern — can be resolved | Respond with concrete data or revision | 30% |
| Gray | Minor or cosmetic | Acknowledge briefly, confirm fix | 10% |
| Green | Positive comment or praise | Note as ammunition for your champion | — |
Which Concerns Are Red
Reviewer score tells you where to look, not how much to flag. A reviewer who lists eight points is usually driven by one or two of them, so marking every comment from a low-score reviewer Red spends the 60% budget on points that move nothing.
The decision test. Mark a concern Red only if both hold:
- You can name the decision it drives: "without this, R3 stays at 3" or "the AC's cited concern stays open". If you cannot name one, it is not Red.
- It is still unresolved. A concern the paper already answers is not score-driving, however fundamental it sounds: answer it by pointing to the evidence (Counterintuitive Rebuttal Principle 3 below) and mark it Orange.
Any one of the following is enough to name the decision for point 1:
- The meta-review or AC comment names the concern as unresolved: the decision is the AC's. Use this only when such a comment is actually in the input.
- It is the core objection of a reviewer who recommends rejection (1-4), whether they call it their main issue or it is simply the substance of their review: the decision is that reviewer's score. This holds even when it is politely phrased and even when the meta-review does not repeat it. Expect one or two per reviewer, not their whole list.
- A reviewer on the fence (5-6) ties it to their reservation: the decision is that reviewer's score.
- Two or more reviewers raise the same fundamental issue independently: the decision is the AC's reading of the consensus.
- If true, it would change the paper's main conclusion: the decision is whether the central claim stands.
Common over-flagging, Orange or Gray instead: a rejecting reviewer's secondary asks; improvement suggestions ("it would be stronger if…") that are neither a rejecting reviewer's core objection nor tied by a fence-sitter to their reservation; points that merely touch the method; minor clarifications.
Red means the concern decides the outcome, not that you can win it. When a Red objection cannot be answered, concede it plainly and narrow the claim instead of spending the budget arguing.
There is no quota. Short, harsh reviews can make most comments Red, and that is then the honest picture: do not demote a rejecting reviewer's core objection to keep the Red list short. When long reviews leave most comments Red, rerun the test on each one; you are probably flagging by score rather than by decision.
Identify the Invisible Question
Behind every reviewer comment is an unspoken question. A comment like "The baselines are outdated" really asks: "Is this method actually competitive with current approaches?" Address the invisible question, not just the surface request.
Step 2: Plan Response Strategy
Categorize Every Concern
| Category | Response Strategy |
|---|---|
| Misunderstanding | Clarify with specific references to the paper; restate the key point |
| Missing experiment | First check whether existing results (including the appendix) already answer it: cite the exact location and restate them. Otherwise run it and show the result inline. If it cannot be run, explain the constraint honestly and narrow the claim; a scoped, concrete promise is the last resort |
| Missing baseline | Point to the comparison if the paper already reports it; otherwise add it, or explain precisely why the baseline is not applicable |
| Writing clarity | Acknowledge and provide revised text in the rebuttal |
| Fundamental concern | Address directly with technical arguments AND additional evidence |
| Minor issue | Thank the reviewer and confirm the fix |
Identify Common Themes
If multiple reviewers raise the same concern, it's almost certainly a real weakness. Consolidate these into a "Common Response" section — this saves word count and demonstrates that you understand the pattern.
Distinguish Actionable vs. Subjective
- Actionable: "Missing comparison with Method X" — you can do this
- Subjective: "The novelty is limited" — harder to address, but can be reframed with evidence
The Champion Strategy
Your rebuttal's real audience is not the negative reviewer — it's the positive one.
Your champion argues on your behalf in the AC discussion, often using your exact words. Write your rebuttal to arm them:
- Make key arguments copy-pasteable — your champion will quote you directly
- Highlight where reviewers agree with each other — consensus strengthens the champion's position
- Flag contradictions between reviewers — if R1 says "limited novelty" but R2 says "interesting approach," your champion can use this
- Lead with strengths before weaknesses — remind the AC what your paper does well
See references/rebuttal-tactics.md for the full 18 tactical rules.
Step 3: Write the Rebuttal
Structure
- Opening: One line thanking reviewers (keep it short)
- Common concerns: Address issues raised by multiple reviewers first — these are highest priority
- Per-reviewer responses: Address remaining concerns in priority order (red → orange → gray), NOT in the order the reviewer wrote them
Per-Concern Format
For each concern, follow this three-part structure:
- Acknowledge: Show you understand the concern (one sentence)
- Respond: Provide your answer — evidence, clarification, new experiment results
- Action: State what you changed in the revision (specific section/table/figure)
Use a fillable template at assets/rebuttal-template.md.
The Neutral Third-Party Test
Before submitting, have someone who hasn't read your paper read only the reviews and your rebuttal. Ask: "Can you tell whether the concerns were addressed?" If not, rewrite.
Counterintuitive Rebuttal Principles
-
Submit a rebuttal even with extreme scores. A paper with scores of 3/8/8 has better odds than you think. The negative reviewer may realize they are an outlier during discussion. But only if you submit a rebuttal — without one, the AC has nothing to work with.
-
Concede something small, win something big. Acknowledging a minor weakness ("We agree that Table 2 could include dataset X for completeness") makes your defense of major points more credible. Pure defense with zero concession reads as unobjective.
-
Existing evidence first, new experiments second, promises last. Before proposing a new experiment, search the submitted paper, main text and appendix, for evidence that already answers the concern, and quote it with its exact table, figure or section: the AC can verify it in the PDF they already have, and discounts promised future work. If the paper does not answer it, a small new experiment with the result shown inline still beats any amount of reasoning; reviewers are trained to be skeptical of arguments, not of data. If the experiment cannot be run, say so and narrow the claim. A promise without results is the weakest move: keep it rare and concrete (what will be run, on which data, by when). A rebuttal stacked with "we will add…" reads as an admission that the paper is incomplete.
-
The best rebuttal is written before submission. Draft responses to likely attacks while writing the paper ("prebuttal"). Two benefits: you often realize the attack is valid and fix the paper, and if the attack comes, you have a polished response ready.
-
Don't defend every point equally. Equal effort signals you don't know which points matter. Allocate your word budget according to the color-coding: 60% red, 30% orange, 10% gray. Reviewers notice when you nail the big issues.
Common Reviewer Concerns
Prepare responses for these frequent concerns. Having a prepared response doesn't mean copying it verbatim — adapt to your specific paper and the reviewer's specific framing. In every row, principle 3 applies first: if the submitted paper already answers the concern, point to that evidence before adding anything.
| Common Concern | Response Strategy |
|---|---|
| "Limited novelty" | Articulate the specific insight; show what prior work cannot do; narrow and sharpen the claim |
| "Marginal improvement" | Emphasize other advantages (speed, generalizability, simplicity); add challenging test cases |
| "Missing ablations" | Point to the ablation if the paper or appendix already has it; otherwise provide the ablation table inline in the rebuttal |
| "Missing baselines" | Point to the comparison if it is already reported; otherwise add it, or explain precisely why it's not applicable |
| "Not reproducible" | Add implementation details; commit to code release with a specific timeline |
| "Limited evaluation" | Add diverse datasets or metrics; if infeasible, explain resource constraints honestly |
| "No limitation discussed" | Add a limitation section in the revision; acknowledge this was an oversight |
| "Overclaimed results" | Weaken specific claims to match evidence; show the revised wording |
| "Unfair comparison" | Use standard evaluation protocols; add commonly reported baselines |
| "Method is engineering, not research" | Identify the scientific insight behind the design; explain why the choice is non-obvious |
| "Metrics don't match claims" | Align each claim with a specific metric; add the missing metric if feasible |
| "Related work incomplete" | Add the missing references; explain the relationship to your work |
Need to run new experiments for the rebuttal? Use the
experiment-craftskill for targeted debugging, orexperiment-pipelinefor a full new experiment stage.
Handoff from Paper Review
This skill picks up where paper-review leaves off. If you used paper-review before submission, these artifacts are especially useful for rebuttal:
| Artifact from paper-review | How It Helps Rebuttal |
|---|---|
| Reject-first simulation | You've already anticipated likely attacks |
| Claim-evidence audit table | Quickly verify whether a reviewer's concern about unsupported claims is valid |
| Prebuttal drafts (Phase 6 of the counterintuitive protocol) | Ready-made response templates for common criticisms |
| Trust scorecard | Identifies weaknesses you can proactively concede |
Reference Navigation
| Topic | Reference File | When to Use |
|---|---|---|
| 18 tactical rules | rebuttal-tactics.md | Detailed writing guidance for structure, content, tone |
| Rebuttal template | rebuttal-template.md | Starting a new rebuttal document |
FAQ
What does the paper-rebuttal skill do?
Guides writing effective rebuttals after receiving peer review feedback. Covers review diagnosis (score-driven color-coding), response strategy (champion identification, common-theme consolidation), tactical writing (18 rules), and counterintuitive rebuttal principles. Use when: user received reviewer scores/comments, needs to write a rebuttal or author response, wants to respond to specific criticism (e.g. 'limited novelty', 'missing baselines'), mentions 'rebuttal', 'reviewer comments', 'author response', or 'respond to reviewers'. Do NOT use for pre-submission self-review (use paper-review instead).
How do I install paper-rebuttal?
Run npx skills add https://github.com/evoscientist/evoskills --skill paper-rebuttal in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/paper-rebuttal/ (personal) or .claude/skills/paper-rebuttal/ (project).
Which AI agents can use paper-rebuttal?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is paper-rebuttal safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains paper-rebuttal?
It is published by evoscientist in evoscientist/evoskills. It has 443 recorded installs.
More from evoscientist/evoskills
paper-review
evoscientist/evoskills
Guides self-review of YOUR OWN academic paper before submission with adversarial stress-testing. Core method: three passes (adversarial deep read; 5-aspect checklist — contribution sufficiency, writing clarity, results quality, testing completeness, method design; mechanical consistency scans and experimental protocol audit of data flow, assumptions, leakage), counterintuitive protocol (reject-first simulation, delete unsupported claims, score trust, promote limitations, attack novelty), reverse-outlining, and figure/table quality checks. Use when: user wants to self-review or self-check their own paper draft before submission, stress-test their claims, prepare for reviewer criticism, or mentions 'self-review', 'check my draft', 'is my paper ready'. Do NOT use for writing a peer review of someone else's paper, and do NOT use after receiving actual reviews (use paper-rebuttal instead). Also runs as a background expert: dispatch it async with a draft path and it reviews end-to-end while
paper-writing
evoscientist/evoskills
Guides writing academic papers section by section using an 11-step workflow with LaTeX templates and counterintuitive writing tactics. Covers Abstract, Introduction, Method, Experiments, Related Work, Conclusion, and Supplementary. Use when: user asks to write or draft a paper section, needs LaTeX templates, wants to improve academic writing quality, optimize novelty framing, or mentions 'write introduction', 'draft method', 'paper writing'. Do NOT use for pre-submission review (use paper-review), experiment execution (use experiment-pipeline), or paper planning/story design (use paper-planning).
research-ideation
evoscientist/evoskills
End-to-end research ideation pipeline: literature grounding → multi-track idea generation (3 personas: innovator/pragmatist/critic) → iterative refinement → ELO tournament ranking → update evo-memory (IDE) → user selects direction → expand into manuscript-quality proposal. Use when: user wants to find a research direction, brainstorm ideas, evaluate idea novelty, design a novel solution, rank/compare research ideas, or generate a research proposal. Do NOT use for finding/searching/reading papers (use paper-navigator), literature survey reports (use research-survey), or planning a paper (use paper-planning).
academic-slides
evoscientist/evoskills
Use this skill for creating or refining an academic slide deck and the talk built around it: structuring a conference talk, thesis defense, lab meeting, or paper-to-slides deck; deciding the narrative arc and slide breakdown; improving slide design and visual hierarchy; planning rehearsal, timing, Q&A, and backup slides; or generating the .pptx. Reach for it when the user is shaping the presentation itself. Do not use for writing the paper, producing standalone speaker notes/scripts/transcripts, making posters, creating isolated figures/charts outside a slide deck, or building non-academic presentations.
paper-planning
evoscientist/evoskills
Guides pre-writing planning for academic papers with 4 structured steps: story design (task-challenge-insight-contribution-advantage), experiment planning (comparisons + ablations), figure design (pipeline + teaser), and 4-week timeline management. Includes counterintuitive planning tactics (write a mock rejection letter to identify weaknesses before writing, narrow before broad claims, design ablations first). Use when: user wants to plan a paper before writing, design story/contributions, plan experiments, create figure sketches, set a writing timeline, or write a pre-emptive rejection letter for planning purposes. Do NOT use for actual writing (use paper-writing), running experiments (use experiment-pipeline), self-reviewing a finished draft (use paper-review), or finding research problems (use research-ideation).
experiment-pipeline
evoscientist/evoskills
Guides structured 4-stage experiment execution with attempt budgets and gate conditions: Stage 1 initial implementation (reproduce baseline), Stage 2 hyperparameter tuning, Stage 3 proposed method validation, Stage 4 ablation study. Integrates with evo-memory (load prior strategies, trigger IVE/ESE) and experiment-craft (5-step diagnostic on failure). Use when: user has a planned experiment, needs to reproduce baselines, organize experiment workflow, or systematically validate a method. Do NOT use for debugging a specific experiment failure (use experiment-craft) or designing which experiments to run (use paper-planning).
Popular education & science skills
teach
mattpocock/skills
Teach the user a new skill or concept, within this workspace.
scaffold-exercises
mattpocock/skills
Create exercise directory structures with sections, problems, solutions, and explainers that pass linting. Use when user wants to scaffold exercises, create exercise stubs, or set up a new course section.
paper-context-resolver
lllllllama/rigorpilot-skills
Rigor Paper Context helper for README-first deep learning repo reproduction. Use only when the README and repository files leave a narrow reproduction-critical gap and the task is to resolve a specific paper detail such as dataset split, preprocessing, evaluation protocol, checkpoint mapping, or runtime assumption from primary paper sources while recording conflicts. Do not use for general paper summary, repo scanning, environment setup, command execution, title-only paper lookup, or replacing README guidance by default.
caveman-learn
juliusbrussee/caveman
Act on a Caveman learn report - review the ranked token sinks, apply cost-lowering fixes with per-edit consent, and report what those fixes returned. Use when asked to lower an agent's token cost, what caveman has saved, to trim a heavy CLAUDE.md, or to offload re-pasted context into cavemem.
gsap-plugins
greensock/gsap-skills
Official GSAP skill for GSAP plugins — registration, ScrollToPlugin, ScrollSmoother, Flip, Draggable, Inertia, Observer, SplitText, ScrambleText, SVG and physics plugins, CustomEase, EasePack, CustomWiggle, CustomBounce, GSDevTools. Use when the user asks about a GSAP plugin, scroll-to, flip animations, draggable, SVG drawing, or plugin registration.
teach-impeccable
pbakaus/impeccable
DEPRECATED: Use /impeccable teach instead. This command has been folded into the impeccable skill.