rebuttal-writing — Claude Code skill: point-by-point reviewer replies
Turns reviewer comments on a paper into a structured, point-by-point rebuttal backed by evidence from the manuscript.
npx skills add lingzhi227/agent-research-skills --skill rebuttal-writing -a claude-codeWhat rebuttal-writing does
The skill takes a file of reviewer comments and splits it into individual concerns, questions and suggestions. Each one gets a category — major concern, minor concern, question, suggestion — plus a note on the core issue behind the wording.
Then it drafts a reply for every point: acknowledge the reviewer, cite the specific sections, equations, tables or experiments that answer the concern, and phrase everything as work already done rather than work promised. Where new experiments are needed, the response describes their results concretely. The output follows a standard format with a section per reviewer and a short summary of changes at the top.
Run it once the reviews are in. Input is the comments file, and you can attach the current draft so the replies point at real sections. Response templates and the format live in ~/.claude/skills/rebuttal-writing/references/rebuttal-prompts.md.
What it helps with
- split reviewer feedback into individual concerns
- draft an evidence-backed reply to each concern
- describe new experiments as already completed
- assemble replies into one document grouped by reviewer
- add a summary of changes at the top
Example prompts for the agent
- parse the reviewer comments in
reviews.txtand write a point-by-point response - draft a rebuttal to
reviews.txt, citing sections and tables from the paper - build the reviewer response from
reviews.txtwith a summary of changes up front
How to install rebuttal-writing
1Skills CLI (Vercel)
npx skills add lingzhi227/agent-research-skills --skill rebuttal-writing -a claude-code2Manually: put the files in place
~/.claude/skills/rebuttal-writing/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/rebuttal-writing/
1Skills CLI (Vercel)
npx skills add lingzhi227/agent-research-skills --skill rebuttal-writing -a codex2Manually: put the files in place
.agents/skills/rebuttal-writing/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add lingzhi227/agent-research-skills --skill rebuttal-writing -a cursor2Manually: put the files in place
.cursor/skills/rebuttal-writing/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install lingzhi227/agent-research-skills rebuttal-writing2Manually: put the files in place
.github/skills/rebuttal-writing/SKILL.md1Skills CLI (Vercel)
npx skills add lingzhi227/agent-research-skills --skill rebuttal-writing -a gemini-cli2Platform CLI
gemini skills install https://github.com/lingzhi227/agent-research-skills --path skills/rebuttal-writingManually: put the files in place
.devin/skills/rebuttal-writing/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add lingzhi227/agent-research-skills --skill rebuttal-writing -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about rebuttal-writing
How do I install rebuttal-writing in Claude?
Run npx skills add lingzhi227/agent-research-skills --skill rebuttal-writing -a claude-code. The skill then sits at ~/.claude/skills/rebuttal-writing/SKILL.md.
What does rebuttal-writing do?
It breaks reviewer comments into separate concerns and writes an evidence-based reply to each, then formats everything into a structured rebuttal document grouped by reviewer.
What input does the skill need?
A file of reviewer comments, either as text or pasted in directly. You can attach the paper draft for reference so replies cite actual sections and results.