aer-rebuttal — Claude Code skill: R&R triage and response letter
aer-rebuttal — a skill for answering a revise-and-resubmit at AER, AER:Insights or AEJ: it splits referee reports into points and helps you decide where to give way and where to hold.
no license ★ 240 updated 2026-09-18
npx skills add franklee16/academic-research-skills --skill aer-rebuttal -a claude-codeWhat aer-rebuttal does
The skill walks you through an R&R at AER, AER:Insights or AEJ. It cuts the editor's letter and every referee report into separate items and numbers them: E1, E2 for the editor, R1.1 and R2.1 for the referees. Each item gets a single label, such as a misreading, a clarity issue, missing evidence, a request outside the paper's scope, a wrong premise, or a threat to the central claim.
Severity decides the move. A note on presentation closes with a cross-reference; a blocking challenge to identification forces a restructure. The skill sets out when to concede, when a short explanation is enough, and when to push back. If two referees contradict each other, it advises siding with the one whose report supports the paper.
Fix the manuscript first, then write the reply against the new version, since page and line numbers in the letter have to match the text. That rule runs through the whole skill. Inside SKILL.md are decision tables and a letter template with a block per comment. First submissions are a different stage, and this skill does not cover them.
What it helps with
- turn a referee report into numbered, labelled items
- choose between conceding a point and rebutting it with reasons
- separate a missing analysis from a buried argument
- draft the reply to the editor with quoted comments
- keep manuscript edits and page references in sync
Example prompts for the agent
- An R&R came back from AER — break the editor letter and both referee reports into points and tell me what to do with each.
- The referees disagree on identification — which position should I back, and how do I answer the other one?
- Draft the response letter against the revised manuscript, with page and line references.
How to install aer-rebuttal
1Skills CLI (Vercel)
npx skills add franklee16/academic-research-skills --skill aer-rebuttal -a claude-code2Manually: put the files in place
~/.claude/skills/aer-rebuttal/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/aer-rebuttal/
1Skills CLI (Vercel)
npx skills add franklee16/academic-research-skills --skill aer-rebuttal -a codex2Manually: put the files in place
.agents/skills/aer-rebuttal/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add franklee16/academic-research-skills --skill aer-rebuttal -a cursor2Manually: put the files in place
.cursor/skills/aer-rebuttal/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install franklee16/academic-research-skills Awesome-Journal-Skills-main/AER-Skills-main/skills/aer-rebuttal2Manually: put the files in place
.github/skills/aer-rebuttal/SKILL.md1Skills CLI (Vercel)
npx skills add franklee16/academic-research-skills --skill aer-rebuttal -a gemini-cli2Platform CLI
gemini skills install https://github.com/franklee16/academic-research-skills --path Awesome-Journal-Skills-main/AER-Skills-main/skills/aer-rebuttalManually: put the files in place
.devin/skills/aer-rebuttal/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.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 aer-rebuttal
How do I install aer-rebuttal in Claude Code?
Run npx skills add franklee16/academic-research-skills --skill aer-rebuttal -a claude-code. The skill file lands at ~/.claude/skills/aer-rebuttal/SKILL.md.
What does aer-rebuttal do?
It breaks editor and referee comments into numbered items, gives each one a category and a severity, then suggests an action: change the paper, explain in the letter, or push back.
Does it help with a first submission?
No, it is built for the stage after an R&R decision. The same collection has a separate aer-submission skill for sending a paper in.