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
Recommend AND run open-source AI tools, agents, Claude Code / Codex skills, and MCP servers for any stage of a literature review — searching, reading, extracting, synthesizing, screening, citation-checking, and paper writing. Use when the user asks "what tool should I use to..." OR "install/run/use <tool> to ..." for research/lit-review work: automating a survey or related-work section, PDF→Markdown extraction for LLMs (MinerU/marker/docling), PRISMA / systematic review (ASReview), citation-backed Q&A over PDFs (PaperQA2), wiring papers into Claude/Cursor via MCP (arxiv/paper-search/zotero servers), or chatting with a Zotero library. Ships a launcher (scripts/litrun.py) that installs each tool in an isolated venv and runs it. Curated catalog of 70+ vetted projects. 支持中英文(用于「文献综述工具选型」与「一键安装/运行」)。
development
Route empirical-research requests through the Auto-Empirical Research Skills catalog when this whole repository is installed as one skill in Codex, CodeBuddy, Claude Code, or another IDE. Use to choose and load the right vendored AERS skill for causal inference, econometrics, replication, data acquisition, manuscript writing, peer review and referee responses, citation checking, de-AIGC editing, or full empirical-paper workflows without reading the entire repository at once.
documentation
Use when the project collects primary data or runs a field, lab, or survey experiment, before the intervention begins — write the pre-analysis plan, size the sample from a power calculation, and register with the AEA RCT Registry. Apply after the design is chosen in aer-identification and before any outcome data are seen.
tools
Guide economists to authoritative data sources with explicit, confirmed data specifications before retrieval; interfaces with Playwright MCP to navigate portals and extract real data, not articles about data.