skills/50-brycewang-aer-skills/skills/aer-referee-sim/SKILL.md
Use when a complete draft exists and needs an adversarial internal review before submission — simulating the AER desk screen and three referee reports with calibrated severity, scoring the paper against the editorial rubric, and producing a prioritized revise list. Apply after aer-consistency passes and before aer-submission; rerun until the simulated verdict is at least major R&R.
npx skillsauth add brycewang-stanford/Awesome-Agent-Skills-for-Empirical-Research aer-referee-simInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Most papers submitted to AER are rejected; the realistic acceptance rate is 6-8 percent, and a large share never reach referees. The cheapest referee report is the one generated before submission — but only if it is as harsh as the real one. The failure mode of self-review (human or AI) is leniency: reviewing the paper one hopes was written instead of the one on the page.
This skill runs the AER editorial process against the draft: a ten-minute desk screen, then three referee reports written from distinct, adversarial priors, then an editor's synthesis with a calibrated verdict and a prioritized revise list. The simulation has one rule that overrides all others:
The simulated reviewers' job is to reject the paper. Every comment must survive the question "would this withstand the authors' best rebuttal?" — but praise requires the same evidence as criticism.
aer-consistency reports all-passDo not use on a half-draft — the simulation will correctly report that the
paper is incomplete, which wastes the run. And do not let it replace
aer-consistency: typo-hunting referees are wasted referees.
Simulate the editor's first pass: ten minutes, first three pages, then the main tables, then the bibliography. The editor is deciding only one thing — is this worth three referees' time?
Work through docs/desk-rejection-audit.md items 1-5 plus three scans:
aer-identification red flags apply on sight)?docs/style-guide.md. Editors read craft
as a proxy for care in the empirics.Output a desk decision with the editor's two-paragraph letter:
DESK DECISION: <reject | send to referees>
LETTER: <the letter an AER editor would actually send>
Calibration: if any Stage 1-2 item in the desk-rejection audit fails, the decision is reject — write the letter and stop. Do not soften a desk reject into "borderline" to keep the simulation going; fix the draft and rerun.
Three referees, three priors, three reading orders. Each writes independently — draft all three before reconciling anything, and never let R2 inherit R1's findings.
Reads: Empirical Strategy first, then Data, then the robustness appendix. Prior: "the design is broken until proven otherwise."
Attacks: the identifying assumption's plausibility in this setting;
missing diagnostics from the aer-identification battery; inference
mismatched to the variation's level; estimand-population gaps (whose effect
is this?); the alternative story the design cannot exclude. R1 re-derives at
least one magnitude from the tables and checks it against the prose.
Reads: Introduction, then the antecedents, then Results against the literature. Prior: "we probably already knew this."
Attacks: novelty against the working-paper frontier (names the closest
papers, including any the draft missed — aer-literature's map is the
checklist); whether magnitudes are plausible next to the literature's;
whether the mechanism evidence distinguishes the favored channel from the
obvious rival; institutional errors a field insider would catch. R2 is the
referee most likely to have written one of the antecedents.
Reads: linearly, as an editor-board member from another subfield. Prior: "why should I care, and can I follow it?"
Attacks: cross-subfield interest (the explicit AER bar); whether the first
three pages are self-contained; under-interpreted results (coefficients
never converted to economic meaning — aer-paper-body rules); exhibit
overload or disorder; the conclusion overreaching the evidence; external
validity left unaddressed.
SUMMARY: <2-3 sentences — the paper as the referee understood it>
MAJOR COMMENTS: <numbered; each one: quote or cite the page/table,
state the problem, state what evidence would resolve it>
MINOR COMMENTS: <numbered, brief>
RECOMMENDATION: <reject | major revision | minor revision | accept>
Rules of engagement:
Score the paper on the rubric in docs/referee-report-rubric.md
(contribution, identification, data, robustness, magnitudes, exposition,
integrity — each 0-5 with anchored definitions), then issue the decision the
reports support:
RUBRIC SCORES: <dimension: score, ...>
VERDICT: <desk reject | reject after review | major R&R | minor R&R>
DECISION LETTER: <editor's letter, naming the comments that drove it>
REVISE LIST: <every major comment, deduplicated, ordered by severity:
blocking → major → minor, each tagged with the skill that fixes it>
Calibration anchors (do not inflate):
aer-consistency (all PASS)
→ aer-referee-sim
→ verdict reject? → route fixes:
identification comments → aer-identification / aer-robustness
novelty comments → aer-literature / aer-topic-selection
interpretation comments → aer-paper-body
framing comments → aer-introduction
exhibit comments → aer-tables-figures
→ revise → aer-consistency → aer-referee-sim (fresh reports)
→ verdict ≥ major R&R on a fresh run → aer-submission
Rerun with fresh reports each time — re-grading old comments measures compliance, not quality. Two consecutive runs at major-R&R-or-better, with no blocking comments, is the exit condition.
Bundled with the installed skill, no repository checkout needed --- read it before the repo resources below:
references/scoring-rubric.md --- anchored 0-5 rubric, verdict mapping, desk-screen and report templatesWhen working from the AER-skills repository or plugin bundle, load only the relevant resource:
docs/referee-report-rubric.mdexamples/referee-report-example.mddocs/desk-rejection-audit.mdskills/aer-identification/SKILL.md
and docs/methods-reference.mdskills/aer-robustness/SKILL.mddocs/style-guide.mdskills/aer-rebuttal/SKILL.mdDESK DECISION: <reject | sent to referees>
REFEREE RECOMMENDATIONS: <R1 / R2 / R3>
RUBRIC SCORES: <list>
VERDICT: <desk reject | reject | major R&R | minor R&R>
BLOCKING COMMENTS: <n — list>
REVISE LIST: <comment → skill routing>
NEXT SKILL: <routed fix skill | aer-submission if exit condition met>
tools
Autonomous multi-round research review loop using MiniMax API. Use when you want to use MiniMax instead of Codex MCP for external review. Trigger with "auto review loop minimax" or "minimax review".
tools
Autonomous research review loop using any OpenAI-compatible LLM API. Configure via llm-chat MCP server or environment variables. Trigger with "auto review loop llm" or "llm review".
tools
Autonomous multi-round research review loop using MiniMax API. Use when you want to use MiniMax instead of Codex MCP for external review. Trigger with "auto review loop minimax" or "minimax review".
tools
Autonomous research review loop using any OpenAI-compatible LLM API. Configure via llm-chat MCP server or environment variables. Trigger with "auto review loop llm" or "llm review".