# Aer Referee Sim > 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. - **Type:** Skill - **Install:** `agentstack add skill-brycewang-stanford-aer-skills-aer-referee-sim` - **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior - **Seller:** [brycewang-stanford](https://agentstack.voostack.com/s/brycewang-stanford) - **Installs:** 0 - **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml) - **Latest version:** 0.1.0 - **License:** MIT - **Upstream author:** [brycewang-stanford](https://github.com/brycewang-stanford) - **Source:** https://github.com/brycewang-stanford/AER-Skills/tree/main/skills/aer-referee-sim ## Install ```sh agentstack add skill-brycewang-stanford-aer-skills-aer-referee-sim ``` Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent. ## About # AER Referee Simulation ## Overview 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.** ## When to Use - A complete draft exists (body, exhibits, bibliography) and `aer-consistency` reports all-pass - Before every submission and resubmission - After a real rejection, to test whether the revision would survive the same reports - When coauthors disagree about whether the paper is ready Do 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. ## Stage 1 — The Desk Screen 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: - **Contribution scan.** Can the editor state the contribution in one sentence after page 3? Would an economist outside the subfield care? - **Design scan.** Is the identification strategy named on page 1-2, and is it a modern design (`aer-identification` red flags apply on sight)? - **Craft scan.** Tables in house style, abstract within 100 words, prose free of the failure patterns in `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: ```text DESK DECISION: LETTER: ``` 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. ## Stage 2 — Three Referee Reports Three referees, three priors, three reading orders. Each writes independently — draft all three before reconciling anything, and never let R2 inherit R1's findings. ### Referee 1 — The identification specialist 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. ### Referee 2 — The field expert 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. ### Referee 3 — The generalist 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. ### Report format (each referee) ```text SUMMARY: MAJOR COMMENTS: MINOR COMMENTS: RECOMMENDATION: ``` Rules of engagement: - Every major comment is **anchored** — it quotes the manuscript or names the exact table/figure. Unanchored vibes ("the paper feels thin") are banned. - Every major comment is **resolvable** — it states what analysis, evidence, or rewrite would satisfy the referee. Comments with no resolution path are editor material, not referee material. - Each referee must produce **at least three major comments** or explicitly certify, against their own checklist, why fewer exist. An AI reviewer that finds nothing major has defaulted to agreeable — restart that report with the prior dialed up. - No praise sandwiches. One sentence of genuine strengths in the summary is the cap. ## Stage 3 — Editor Synthesis and Verdict 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: ```text RUBRIC SCORES: VERDICT: DECISION LETTER: REVISE LIST: ``` Calibration anchors (do not inflate): - Any rubric dimension at 0-1 → reject. Identification ≤ 2 → reject; no robustness round fixes a broken design. - Major R&R requires: contribution ≥ 3, identification ≥ 3, no dimension below 2. This is already a top-decile outcome for real submissions. - Minor R&R from a simulation should be **rare** — if the first run returns minor R&R, suspect leniency and rerun Stage 2 with the priors sharpened. ## The Loop ```text 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. ## Honesty Constraints for the Simulation - The reviewers attack the manuscript, not a summary of it. If the draft is too long to hold at once, review it section by section against each referee's checklist — never from recall. - Findings of fact (a wrong conversion, a missing diagnostic, a scooped contribution) must be verified before they enter a report; a simulated referee who hallucinates a flaw costs a revision round. - Report the verdict to the user **unsoftened**. "The simulation desk- rejected the draft for X" is the deliverable, not a diplomatic summary. - The simulation cannot certify acceptance — only that the draft survives the attacks this skill knows how to mount. Say so in the output. ## Common Failure Modes - Referees that paraphrase the paper's own framing back as praise - Three reports that are one report with three names — the priors and reading orders exist to prevent this - Major comments that are really minor (citation formatting promoted to "major" pads the count without testing the paper) - Re-running the simulation until it happens to pass, without changing the draft — variance is not improvement - Treating the simulated verdict as a prediction of the real one rather than a lower bound on preparedness ## Repository Resources When working from the AER-skills repository or plugin bundle, load only the relevant resource: - Scoring rubric with anchored 0-5 definitions and a calibrated sample report: `docs/referee-report-rubric.md` - Complete worked simulation (two runs, three reports, routed revise list): `examples/referee-report-example.md` - Desk-screen checklist the Stage 1 editor runs: `docs/desk-rejection-audit.md` - Identification red flags Referee 1 hunts: `skills/aer-identification/SKILL.md` and `docs/methods-reference.md` - Referee-anticipation battery Referee 1 checks for completeness: `skills/aer-robustness/SKILL.md` - Prose failure patterns the desk screen scans: `docs/style-guide.md` - Response-letter conventions for acting on the revise list: `skills/aer-rebuttal/SKILL.md` ## Handoff ```text DESK DECISION: REFEREE RECOMMENDATIONS: RUBRIC SCORES: VERDICT: BLOCKING COMMENTS: REVISE LIST: NEXT SKILL: ``` ## Anti-Patterns - Running the simulation as a checklist instead of as three hostile readers with different stakes - Letting the model grade its own prose generously because it recognizes it - Skipping Stage 1 because "we know it won't desk-reject" — the desk screen catches different failures than referees do - Accepting one lucky major-R&R run as the exit condition - Using the simulation's praise in the cover letter — its only export is the revise list ## Source & license This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code. - **Author:** [brycewang-stanford](https://github.com/brycewang-stanford) - **Source:** [brycewang-stanford/AER-Skills](https://github.com/brycewang-stanford/AER-Skills) - **License:** MIT Install and usage instructions live in the source repository linked above. ## Pricing - **Free** — Free ## Security capabilities Automated source analysis of v0.1.0 — what this tool can access: - **Network access:** no - **Filesystem access:** no - **Shell / process execution:** no - **Environment & secrets:** no - **Dynamic code execution:** no *"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.* ## Versions - **0.1.0** — security scan: passed — Imported from the upstream source. ## Links - Listing page: https://agentstack.voostack.com/l/skill-brycewang-stanford-aer-skills-aer-referee-sim - Seller: https://agentstack.voostack.com/s/brycewang-stanford - Browse the marketplace: https://agentstack.voostack.com/browse --- Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.