Agent skill

Paper Rebuttal

by EvoScientist in EvoScientist/EvoSkills

Guides writing effective rebuttals after receiving peer review feedback.

Apache-2.0Auto-check passedResearch & Science

Install Paper Rebuttal

skills CLI
$ npx skills add EvoScientist/EvoSkills --skill paper-rebuttal -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install EvoScientist/EvoSkills paper-rebuttal --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/EvoScientist/EvoSkills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/paper-rebuttal .claude/skills/paper-rebuttal && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
paper-rebuttal
GitHub stars
478
Used in
3 other repos
Token cost
~3.4k tokens
SKILL.md length
1,807 words
Files
3 (incl. references, assets)
Skills in repo
16
Repo updated
First seen
Licence
Apache-2.0

At a glance

Guides writing effective rebuttals after receiving peer review feedback.

  • Works in 3 steps: Diagnose Reviews → Plan Response Strategy → Write the Rebuttal
  • : user received reviewer scores/comments
  • SKILL.md covers When to Use This Skill, Step 1: Diagnose Reviews, Step 2: Plan Response Strategy and Step 3: Write the Rebuttal, plus 4 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Paper Rebuttal is an agent skill from EvoScientist/EvoSkills. 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…

Its SKILL.md is about 3.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including reference files and assets (for example `assets/rebuttal-template.md` and `references/rebuttal-tactics.md`).

It sits in Research & Science, covering Peer review. The repository describes itself as: 🧬 Extend EvoScientist with Installable Skill & Knowledge Packs. The licence is Apache-2.0.

When your agent uses it

  • : user received reviewer scores/comments
  • Needs to write a rebuttal
  • Author response
  • Wants to respond to specific criticism (e.g

Example prompts

  • “limited novelty”
  • “missing baselines”
  • “rebuttal”
  • “/paper-rebuttal”

Requirements

  • Pre-approved tools (allowed-tools): write_file, edit_file, read_file, think_tool

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. Diagnose Reviews
  2. Plan Response Strategy
  3. Write the Rebuttal

What it can do on your machine

Read from SKILL.md and the folder at commit 9a9f8cf. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • write_file
    • edit_file
    • read_file
    • think_tool

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Paper Rebuttal loads about 3.4k tokens when it runs, and up to ~5k if it reads all its reference files. Until then it costs about 156 tokens; SKILL.md has 1,807 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~156
When it runs · the whole SKILL.md, loaded when a task matches
~3.4k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from EvoScientist/EvoSkills at commit 9a9f8cf, republished under its Apache-2.0 licence (© EvoScientist). 1,807 words, ~3,378 tokens.

Download SKILL.mdSave it as .claude/skills/paper-rebuttal/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
paper-rebuttal
description
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).
allowed-tools
write_file, edit_file, read_file, think_tool
metadata.author
EvoScientist
metadata.version
1.1.0
metadata.tags
core, writing, academic-writing, peer-review

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-review skill.

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 RangeTypical SituationYour Strategy
7+Already your championArm them with ammunition for the discussion phase
5-6On the fence, 1-2 concerns holding them backIdentify and resolve those specific concerns
3-4Fundamental objectionDetermine if the objection is addressable; if not, focus elsewhere
1-2Strong rejectionIdentify 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:

ColorMeaningActionBudget
RedScore-driving concern — this is why the score is lowAddress first, maximum effort and evidence60%
OrangeAddressable concern — can be resolvedRespond with concrete data or revision30%
GrayMinor or cosmeticAcknowledge briefly, confirm fix10%
GreenPositive comment or praiseNote 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:

  1. 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.
  2. 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
CategoryResponse Strategy
MisunderstandingClarify with specific references to the paper; restate the key point
Missing experimentFirst 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 baselinePoint to the comparison if the paper already reports it; otherwise add it, or explain precisely why the baseline is not applicable
Writing clarityAcknowledge and provide revised text in the rebuttal
Fundamental concernAddress directly with technical arguments AND additional evidence
Minor issueThank 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:

  1. Make key arguments copy-pasteable — your champion will quote you directly
  2. Highlight where reviewers agree with each other — consensus strengthens the champion's position
  3. Flag contradictions between reviewers — if R1 says "limited novelty" but R2 says "interesting approach," your champion can use this
  4. 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
  1. Opening: One line thanking reviewers (keep it short)
  2. Common concerns: Address issues raised by multiple reviewers first — these are highest priority
  3. Per-reviewer responses: Address remaining concerns in priority order (red → orange → gray), NOT in the order the reviewer wrote them
Show full SKILL.md (745 more words)Show less
Per-Concern Format

For each concern, follow this three-part structure:

  1. Acknowledge: Show you understand the concern (one sentence)
  2. Respond: Provide your answer — evidence, clarification, new experiment results
  3. 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

  1. 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.

  2. 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.

  3. 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.

  4. 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.

  5. 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 ConcernResponse 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-craft skill for targeted debugging, or experiment-pipeline for 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-reviewHow It Helps Rebuttal
Reject-first simulationYou've already anticipated likely attacks
Claim-evidence audit tableQuickly 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 scorecardIdentifies weaknesses you can proactively concede

Reference Navigation

TopicReference FileWhen to Use
18 tactical rulesrebuttal-tactics.mdDetailed writing guidance for structure, content, tone
Rebuttal templaterebuttal-template.mdStarting a new rebuttal document

© EvoScientist, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files (references, assets) in skills/paper-rebuttal of EvoScientist/EvoSkills.

  • SKILL.md
  • assets/rebuttal-template.md
  • references/rebuttal-tactics.md

Open the folder on GitHubat commit 9a9f8cf

Used in 3 other repositories

We found 3 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 3 other GitHub owners. This page covers the copy in EvoScientist/EvoSkills, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Paper Rebuttal next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Paper Rebuttal compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Paper Rebuttal this skillEvoScientist/EvoSkills4783 repos~3.4kAutomated safety check: PassApache-2.0
Peer Reviewspacering-net/codeg3.9k17 repos~5.9kAutomated safety check: NotesMIT
Scholar Evaluationspacering-net/codeg3.9k11 repos~3.2kAutomated safety check: PassMIT
Academic Paper Writing PipelineImbad0202/academic-research-skills51k—~16kAutomated safety check: PassCustom licence
Academic Paper ReviewerImbad0202/academic-research-skills51k—~11kAutomated safety check: PassCustom licence
Peer ReviewK-Dense-AI/claude-scientific-writer2.4k2 repos~3.1kAutomated safety check: NotesMIT

Similar skills

  • Peer Review

    spacering-net/codeg

    Structured manuscript/grant review with checklist-based evaluation.

    3.9k GitHub starsUsed in 17 repos~5.9k tokens
    Research & ScienceAuto-check: notes
  • Scholar Evaluation

    spacering-net/codeg

    Systematically evaluate scholarly work using the ScholarEval framework, providing structured assessment across research quality dimensions including problem formulation, methodology, analysis, and…

    3.9k GitHub starsUsed in 11 repos~3.2k tokens
    Research & ScienceAuto-check passed
  • Academic Paper Writing Pipeline

    Imbad0202/academic-research-skills

    Runs a 12-agent pipeline that plans, drafts, cites, reviews and formats academic papers, with modes for revision, rebuttals, abstracts and citation checks.

    51k GitHub stars~16k tokensUpdated yesterday
    Research & ScienceAuto-check passed
  • Academic Paper Reviewer

    Imbad0202/academic-research-skills

    Simulates a journal peer review of a manuscript with a five-seat reviewer panel, an editorial synthesizer and several review modes.

    51k GitHub stars~11k tokensUpdated yesterday
    Research & ScienceAuto-check passed
  • Peer Review

    K-Dense-AI/claude-scientific-writer

    Prepare evidence-bounded, constructive peer-review drafts and structured manuscript assessments.

    2.4k GitHub starsUsed in 2 repos~3.1k tokens
    Research & ScienceAuto-check: notes
  • Academic Research Pipeline

    Imbad0202/academic-research-skills

    Orchestrates a ten-stage academic workflow from research to finished manuscript, including integrity checks, two rounds of peer review and revision.

    51k GitHub stars~15k tokensUpdated yesterday
    Research & ScienceAuto-check passed

More from EvoScientist/EvoSkills

All 16 skills in this repo
  • Evomath Tao

    EvoScientist/EvoSkills

    A skill your agent uses whenever the user submits a non-trivial mathematical claim that needs a rigorous proof or audit.

    478 GitHub starsUsed in 2 repos~3.8k tokens
    Auto-check passed
  • Paper Figures

    EvoScientist/EvoSkills

    A skill your agent uses to produce standalone, publication-ready PNG graphics and reproducible matplotlib scripts from tabular data (CSVs or DataFrames).

    478 GitHub starsUsed in 1 repo~4.4k tokens
    Auto-check passed
  • Experiment Iterative Coder

    EvoScientist/EvoSkills

    Iterative code refinement through plan → code → evaluate → refine cycles.

    478 GitHub starsUsed in 3 repos~2.5k tokens
    Auto-check passed
  • 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…

    478 GitHub starsUsed in 3 repos~2.4k tokens
    Auto-check passed
  • Research Survey

    EvoScientist/EvoSkills

    Generates structured literature survey reports from collected papers using a multi-stage pipeline: outline generation (query-type adaptive) → draft survey → section-by-section expansion → summary…

    478 GitHub starsUsed in 3 repos~2.5k tokens
    Auto-check passed
  • Paper Navigator

    EvoScientist/EvoSkills

    Find and read academic papers (S2 + arXiv). An agent skill from EvoScientist/EvoSkills.

    478 GitHub stars~6.3k tokensUpdated 10 days ago
    Auto-check: notes

Questions about Paper Rebuttal

What does Paper Rebuttal do?

Guides writing effective rebuttals after receiving peer review feedback. Paper Rebuttal is an agent skill from EvoScientist/EvoSkills. Guides writing effective rebuttals after receiving peer review feedback.

When should I use Paper Rebuttal?

Paper Rebuttal fits situations like: : user received reviewer scores/comments; needs to write a rebuttal; author response; wants to respond to specific criticism (e.g.

How do I install Paper Rebuttal in Claude Code?

Run `npx skills add EvoScientist/EvoSkills --skill paper-rebuttal -a claude-code`. Or copy the skill folder (skills/paper-rebuttal in EvoScientist/EvoSkills) into .claude/skills/paper-rebuttal in your project. Claude Code loads it when a task matches its description.

How do I install Paper Rebuttal in Codex?

Run `npx skills add EvoScientist/EvoSkills --skill paper-rebuttal -a codex`. Or copy the skill folder (skills/paper-rebuttal in EvoScientist/EvoSkills) into .agents/skills/paper-rebuttal in your project. Codex loads it when a task matches its description.

Can I use Paper Rebuttal in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add EvoScientist/EvoSkills --skill paper-rebuttal -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/paper-rebuttal, .gemini/skills/paper-rebuttal, .github/skills/paper-rebuttal and .opencode/skills/paper-rebuttal in your project.

What does Paper Rebuttal need to run?

SKILL.md names no scripts, command-line tools or credentials: Paper Rebuttal is instructions for the agent only. Its frontmatter pre-approves these tools: write_file, edit_file, read_file, think_tool.

Does Paper Rebuttal access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Paper Rebuttal safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Paper Rebuttal use?

Paper Rebuttal is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Paper Rebuttal use?

About 3.4k tokens (SKILL.md is roughly 14k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.6k tokens, read only when the agent opens those files.

What are the alternatives to Paper Rebuttal?

Skills that share tags, products or a category with Paper Rebuttal: Peer Review (spacering-net/codeg, 3.9k stars), Scholar Evaluation (spacering-net/codeg, 3.9k stars), Academic Paper Writing Pipeline (Imbad0202/academic-research-skills, 51k stars) and Academic Paper Reviewer (Imbad0202/academic-research-skills, 51k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Paper Rebuttal?

EvoScientist (a GitHub organization) maintains it in EvoScientist/EvoSkills, which has 478 GitHub stars. The repository holds 16 skills in this directory. The repository was last updated on September 30, 2026.

Source: EvoScientist/EvoSkills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.