# aer-referee-sim

aer-referee-sim runs a finished manuscript through a mock AER desk screen and three referees, then returns a verdict and a prioritized revise list.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 240 repo stars
- Author: franklee16
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/franklee16/academic-research-skills/tree/HEAD/Awesome-Journal-Skills-main/AER-Skills-main/skills/aer-referee-sim/SKILL.md
- Updated: 2026-09-18
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/aer-referee-sim

## What it does

This skill stages the American Economic Review process on a finished draft. Stage one is the editor's quick pass: opening pages, main tables, bibliography. The editor only asks whether the paper deserves three referees' time, so the run checks whether the contribution fits in one sentence, whether an identification strategy is named early, and whether exhibits follow house style. A failed item in the desk audit ends the run with a rejection letter.

If the draft gets through, three referees read it separately. One attacks the identifying assumption and re-derives a magnitude from the tables; a second checks novelty against current working papers; a third, from another subfield, asks whether the first pages stand alone. Major comments must point at a page or table and say what evidence would settle them. The editor then scores the paper on a fixed rubric, issues a verdict and merges the comments into one revise list, blocking items first, each tagged with the skill that fixes it.

You need a complete draft with exhibits and bibliography, plus an `aer-consistency` run that reports all-pass. Feed it half a manuscript and the simulation simply reports the paper as unfinished, so the run goes to waste.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add franklee16/academic-research-skills --skill aer-referee-sim -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/aer-referee-sim/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/aer-referee-sim/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add franklee16/academic-research-skills --skill aer-referee-sim -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/aer-referee-sim/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add franklee16/academic-research-skills --skill aer-referee-sim -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/aer-referee-sim/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install franklee16/academic-research-skills Awesome-Journal-Skills-main/AER-Skills-main/skills/aer-referee-sim
```

2. **Manually: put the files in place**
- File: `.github/skills/aer-referee-sim/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add franklee16/academic-research-skills --skill aer-referee-sim -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/franklee16/academic-research-skills --path Awesome-Journal-Skills-main/AER-Skills-main/skills/aer-referee-sim
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/aer-referee-sim/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/franklee16/academic-research-skills/tree/HEAD/Awesome-Journal-Skills-main/AER-Skills-main/skills/aer-referee-sim/SKILL.md

## When to use it
- run a mock desk screen before sending the paper out
- collect three independent referee reports with different priors
- merge scattered comments into one ordered revise list
- test after a real rejection whether the revision would survive the same reports
- settle a coauthor dispute about whether the draft is ready

## Example prompts
- Run `aer-referee-sim` on `paper/draft.tex`: desk screen first, then the three reports.
- Do the editor synthesis, score the rubric dimensions and give me the verdict with the revise list.
- Rerun the simulation with harsher referee priors, the last verdict felt lenient.

## Similar
- [academic-research-suite](https://affpapa.org/en/nevibecode/skills/academic-research-suite.md) — skill · 2200 installs
- [paper-revision](https://affpapa.org/en/nevibecode/skills/paper-revision.md) — skill · 1900 installs
- [rebuttal-writing](https://affpapa.org/en/nevibecode/skills/rebuttal-writing.md) — skill · 1700 installs
- [review-response](https://affpapa.org/en/nevibecode/skills/review-response.md) — skill · 568 installs
- [paper-review](https://affpapa.org/en/nevibecode/skills/evoscientist-paper-review.md) — skill · 530 installs
- [paper-rebuttal](https://affpapa.org/en/nevibecode/skills/paper-rebuttal.md) — skill · 457 installs

From the same set: [franklee16/academic-research-skills](https://affpapa.org/en/nevibecode/by/franklee16/academic-research-skills.md) — 98 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
