skills/50-brycewang-aer-skills/skills/aer-literature/SKILL.md
Use when positioning a manuscript against the existing economics literature, building the antecedents map for the introduction, deciding what to cite, or verifying that every reference in the bibliography is real, correctly attributed, and cited to the published version. Apply at topic selection for the novelty scan and again before drafting the introduction.
npx skillsauth add brycewang-stanford/Awesome-Agent-Skills-for-Empirical-Research aer-literatureInstall 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.
This skill does two jobs that AER referees grade separately:
The second job is non-negotiable for AI-assisted manuscripts. Language models produce plausible-looking citations that do not exist, attach real authors to invented titles, and attribute findings to papers that show the opposite. One hallucinated reference, found by a referee, destroys the credibility of every other sentence in the paper. The working rule:
No citation is written from memory. Every entry is verified against a fetched source before it enters the bibliography, and every claim about a paper is verified against that paper's actual text.
aer-topic-selection, to run the novelty scan before committingaer-introduction, to build the antecedents paragraphaer-consistency)Run all five channels — each finds papers the others miss:
Log every search (channel, query, date, hits) — the log answers the referee
who asks "did you know about X?" and feeds the novelty audit in
aer-topic-selection.
Reduce the search to the 3-6 closest papers and fill this table honestly — it is the skeleton of the introduction's antecedents paragraph and the evidence base for the contribution claim:
| Paper | Question | Data / setting | Identification | Headline finding | What it does not do | |---|---|---|---|---|---| | A (2019) | ... | ... | ... | ... | ... |
Rules:
aer-topic-selection rather than writing around the conflict.The value-added paragraph claims one primary move (plus at most two supporting ones):
| Move | Defensible when | |---|---| | New question | No antecedent asks it — and it matters that nobody has | | New identification | Antecedents are correlational or use a now-rejected design | | New data | Resolution, coverage, or linkage the literature lacked | | New mechanism | The why was open even though the whether was settled | | Opposite / corrected finding | A credibly identified sign flip or magnitude revision | | Unification | Two literatures explained by one framework or fact |
Match the claim to the map: a "new identification" claim dies instantly if row 3 of the antecedents table already used the same design.
docs/methods-reference.md, entries in
references.bib); the source for every institutional fact and every
benchmark magnitude used in Results.Run this pipeline for every reference. No step is skippable for entries the model "remembers."
Verify against an authoritative record: resolve the DOI (Crossref / doi.org), or match the exact title and author list on the journal page, RePEc, or the NBER/SSRN abstract page. A reference with no resolvable DOI and no locatable landing page does not go in the bibliography. Use a web search or fetch for every entry; if a Zotero or reference-manager connection is available, import from the verified record rather than typing fields.
Check, character by character, against the verified record: full author list and order, spelling and diacritics, year, exact title, journal, volume, issue, pages, DOI. The most common AI corruption modes: swapped coauthors, off-by-one years (working paper vs. publication), a real author pair attached to an invented title, and the wrong journal in the right family (AEJ: Applied vs. AEJ: Policy).
For every in-text sentence of the form "[Author (year)] find/show/argue X," read at least the abstract — and the relevant table if a magnitude is quoted. The claim must match what the paper actually establishes, including sign, population, and design caveats. Misattribution to a real paper is more damaging than a fake one, because the referee may be its author.
Check that the paper has not been retracted or corrected, and whether a cited working paper has since been published (then cite the journal version). For replication-contested results, cite the dispute or choose a different benchmark.
Maintain a verification ledger alongside references.bib:
KEY DOI-OK FIELDS-OK CLAIM-OK VERSION CHECKED
goodman_bacon_2021 yes yes yes published 2026-06-12
hjort_poulsen_2019 yes yes yes published 2026-06-12
Any row that cannot reach all-yes is removed from the manuscript or explicitly flagged to the user as unverified. Never silently keep an unverified citation.
author_author_year lowercase
(matching references.bib in this repository).aer-consistency runs this check as part of the full-manuscript
audit.Bundled with the installed skill, no repository checkout needed --- read it before the repo resources below:
references/citation-verification-protocol.md --- fetch-before-cite protocol, claim-audit table, BibTeX hygieneWhen working from the AER-skills repository or plugin bundle, load only the relevant resource:
docs/methods-reference.md and references.bibexamples/modern-aer-exemplars.mdexamples/aer-exemplars.mdskills/aer-topic-selection/SKILL.mdCLOSEST PAPERS MAPPED: <n> (target 3-6)
SCOOP RISK: <none found / named paper + implication>
POSITIONING MOVE: <new question | identification | data | mechanism | correction | unification>
REFERENCES VERIFIED: <n>/<total> (existence / fields / claim / version)
UNVERIFIED ENTRIES: <list, or "none — all verified">
NEXT SKILL: <aer-introduction | aer-topic-selection | aer-consistency>
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.