AER Paper Body
Overview
The introduction decides whether the editor sends the paper out; the body
sections decide what the referees write. Referees live in Data, Empirical
Strategy, and Results, checking that the estimand is defined, the assumption
stated, the magnitudes interpreted, and the prose matched to the tables. Draft
the body before the introduction — the introduction summarizes a paper that
already exists, and writing it first produces promises the body fails to keep.
When to Use
- The empirics are stable (after
aer-identification and aer-robustness)
and the manuscript needs full section drafts
- A results section reads like a table walk-through ("Column 1 shows...") and
needs narration surgery
- A referee called the paper "hard to follow," "under-interpreted," or "reads
like a report"
- Coefficients are reported but never converted into economic magnitudes
- The conclusion restates the abstract and needs to do real work
Canonical Section Architecture
A full-length empirical AER paper, after the unlabeled introduction:
I. Background (or: Institutional Setting; Policy Context)
II. Data (sources, sample construction, measurement, summary stats)
III. Empirical Strategy (estimand, equation, identifying assumption, inference)
IV. Results (main estimates, dynamics, robustness pointers)
V. Mechanisms (or: Heterogeneity and Mechanisms; Interpretation)
VI. Conclusion
Variants: a conceptual framework goes between Background and Data (or
replaces Background for theory-led papers); AER: Insights compresses to Data
and Design → Results → Discussion; structural papers add Model and Estimation,
where the rules below bind with more force, not less. One rule binds
everywhere: every term, dataset, and design feature is defined before first
use — referees read linearly on the first pass.
Section I — Background / Institutional Setting
Give exactly the institutional detail needed to (a) locate the identifying
variation and (b) believe the identifying assumption — nothing else.
- Lead with the institution or policy, not the literature. History belongs
here only if it explains the variation.
- State who is treated, when, by what rule, and who decided. If assignment
is discretionary, say so and explain how the design handles it.
- Length 1.5-3 typeset pages; surplus is almost always literature review in
disguise — cut it or move it to the intro's antecedents paragraph.
- Cite a primary source (statute, agency document, administrative report)
for every institutional claim, not a secondhand economics paper.
Optional Section — Conceptual Framework
Include one only if it generates a testable prediction the empirics then test,
defines the estimand's welfare interpretation (a reduced-form coefficient as a
sufficient statistic), or disciplines magnitudes (what effect size theory
permits).
- Keep it stylized — two-period, two-type, linear where possible. Push
derivations to the appendix; state propositions and intuition in the text.
- End with an explicit bridge naming the predictions taken to the data; each
must reappear, by name, in Results or Mechanisms.
- Do not bolt on a model that re-derives "demand slopes down." Referees read
decorative theory as padding and say so.
Section II — Data
Referees check this section against the replication package line by line.
- Sources. For each dataset: name, producer, access mode, years, unit of
observation, and a citation. If access is restricted, say how it was obtained
(this feeds
aer-replication).
- Sample construction — the most under-written block in rejected papers.
Report the funnel explicitly with counts (raw file → each drop with its count
and rationale → analysis sample). Counts must match the replication package
exactly (
aer-consistency audits this); flag consequential restrictions the
robustness section relaxes.
- Variables and measurement. Define outcome and treatment precisely, with
units, in prose (the full variable table lives in the appendix). Discuss
measurement error where a referee would: self-reports, imputation,
top-coding, deflators (name the index and base year). State the level of
aggregation and why it matches the design.
- Summary statistics. Narrate Table 1, do not re-read it aloud. Two to four
facts, each tied to a design decision: is the sample representative, are the
groups comparable pre-treatment, and what features (skewness, mass points,
attrition) shape specification choices.
Section III — Empirical Strategy
The section referees read most carefully. Four mandatory components, in order:
estimand → equation → identifying assumption → inference.
Estimand first, one sentence before any equation: "Our object of interest
is the average effect of [treatment] on [outcome] among [population],
[horizon]." If the design recovers a local effect (LATE, effect at the cutoff,
ATT for switchers), say so here, not in the conclusion's limitations paragraph.
Y_{ict} = \beta\, D_{ct} + \alpha_c + \gamma_t + X_{ict}'\delta + \varepsilon_{ict}
- Define every symbol in the sentence after the equation, every subscript
included (what each index ranges over; what $D_{ct}$ codes). Keep subscript
order consistent across equations and tables. Number displayed equations;
refer to "equation (1)."
- State which coefficient is the object of interest and what variation
identifies it once controls and fixed effects absorb the rest.
- For modern DiD, write the ATT(g,t) estimand and aggregation explicitly rather
than pretending the design is equation-(1) TWFE — the estimator choice comes
from
aer-identification.
- Identifying assumption: state it formally and in words, then preview
the evidence. The unit of writing is "assumption — threat — evidence"; name
the two or three most plausible violations and point to where each is met.
- Inference: one paragraph — clustering level and why it matches the
design's variation, number of clusters, and any small-cluster correction
(wild cluster bootstrap) or design-specific inference (AR confidence sets,
randomization inference). Never leave inference to the table notes alone.
Section IV — Results
The narration discipline
One paragraph per claim, not per table. Each results paragraph:
- Finding first. The opening sentence states the economic finding with its
magnitude, not the table's existence: "The reform raises earnings by 4.2
percent (Table 3, column 4)," never "Table 3 presents the results."
- Evidence. Where the number comes from and how it moves across
specifications (added controls, finer fixed effects, alternative samples).
- Interpretation. Convert the coefficient into economic units and
benchmark it.
Column-by-column narration without a finding-first sentence is the most
reliable marker of a weak results section.
Magnitude interpretation
Every headline coefficient gets three conversions: (1) native units —
log-outcome coefficients are log points; use the exact 100·(e^β − 1) whenever
|β| > 0.10, and never confuse percent with percentage points; (2)
relative to the sample — against the dependent variable's mean or SD; (3)
relative to the literature or a policy lever. Report the baseline rate next
to every binary marginal effect. If the implied magnitude is implausible, say
so and investigate before a referee does. Worked conversions:
examples/results-section-example.md; the percent/percentage-point table lives
in aer-consistency.
Precision and back-of-envelope
- Quote point estimates and standard errors exactly as the table shows
them. "Significant at the 5 percent level," never "almost significant." For
nulls, report the CI and what it rules out, distinguishing a precise zero
from an uninformative one. Line-level rules:
docs/style-guide.md.
- Close a high-impact results section with one disciplined aggregate
calculation: every input and its source stated, multiplied through in one
visible chain, rounded honestly — not a cascade of unsourced products. If it
needs more than a paragraph, it becomes its own short section. Worked
example:
examples/results-section-example.md.
Robustness pointers
The results section cites robustness, it does not contain it: one paragraph
summarizing the aer-robustness battery ("stable across clustering, sample,
and specification variants; Appendix B reports the full set") plus the single
most important check shown inline.
Section V — Mechanisms
Organize by candidate explanation, not by table:
- Name the two or three channels consistent with the main result, including
the ones you will rule out.
- For the favored channel, present the theory-predicted heterogeneity and
auxiliary outcomes ("if the channel is skill-biased adoption, effects should
concentrate in tradeable services — they do, Table 5").
- For each alternative, state the sharpest version of the referee's objection,
then the evidence against it. Steelman first, then answer.
- Close with calibrated language ("most consistent with [channel]," not "we
prove the mechanism"). Mechanism evidence is consistency evidence; only the
main effect carries design-based identification (see
aer-identification).
Section VI — Conclusion
Short (half a page to one page), doing four things:
- Restate the question and the headline magnitude in fresh words — no abstract
sentences copied verbatim (
aer-consistency flags duplication).
- State the external-validity boundary: population, period, policy margin, and
the complier/locality caveat if the design implies one.
- Draw the one policy or theory implication the evidence supports — one step
beyond the results, never three.
- At most two sentences on specific open questions this paper makes
answerable, not "more research is needed."
No new results, no new citations, no new caveats that belong in Results.
Cross-Section Consistency Rules
- The introduction's promises (contributions, magnitudes, evidence) map
one-to-one onto body sections; nothing promised is undelivered and nothing
major appears unannounced.
- Numbers, sample sizes, and specification labels match the tables exactly
everywhere —
aer-consistency audits this before submission.
- Tense: present for what the paper does and finds; past for data collection
and historical events.
- Prose follows
docs/style-guide.md — finding-first sentences, no filler
transitions, no AI-pattern tics.
Repository Resources
Bundled with the installed skill, no repository checkout needed --- read it
before the repo resources below:
references/section-skeletons.md --- per-section skeletons and conclusion-first results narration rules
Load only the relevant resource:
- Worked results-section narration (same fictional paper as the intro example):
examples/results-section-example.md
- Sentence- and paragraph-level prose rules:
docs/style-guide.md
- Estimator, diagnostic, and citation defaults for Section III:
docs/methods-reference.md
- Model introduction the body must stay consistent with:
examples/intro-example.md
- Code that should produce every number quoted in Results:
templates/stata/,
templates/r/, or templates/python/
Handoff
SECTIONS DRAFTED: <Background | Framework | Data | Strategy | Results | Mechanisms | Conclusion>
ESTIMAND STATED: <yes / no — sentence>
SAMPLE FUNNEL REPORTED: <yes / no>
HEADLINE MAGNITUDE CONVERSIONS: <log-points / percent / vs-mean / vs-literature>
BACK-OF-ENVELOPE CALCULATION: <present / not applicable>
MECHANISM CHANNELS: <favored + ruled-out list>
NEXT SKILL: <aer-introduction | aer-tables-figures | aer-consistency>
Anti-Patterns
- Writing the introduction first and forcing the body to keep its promises
- Narrating tables instead of findings ("Table 4 shows the results. Column 1
reports...")
- Reporting a 0.31 log-point effect as "31 percent" (it is 36 percent), or
never benchmarking the magnitude at all
- The estimand defined nowhere — "the effect" means three populations in three
sections
- The sample funnel absent, so the referee reconstructs (and mistrusts) the Ns
- A conceptual framework added after the results to decorate them
- Mechanisms organized as "more regressions," or claimed with the confidence of
the identified main effect
- A two-page conclusion introducing limitations Results hid, or paragraphs
recycled verbatim into the abstract
- Institutional background with no source for any factual claim
1---2name: aer-paper-body3description: Use when drafting or revising the body sections of an AER, AER:Insights, or AEJ manuscript — institutional background, data, empirical strategy, results, mechanisms, and conclusion. Covers equation conventions, results-paragraph narration, magnitude interpretation, and back-of-envelope policy calculations. Apply after the empirics are stable and before or alongside aer-introduction.4metadata:5 source: https://skillmd.com/skills/brycewang-stanford/aer-paper-body6---78# AER Paper Body910## Overview1112The introduction decides whether the editor sends the paper out; the **body13sections decide what the referees write**. Referees live in Data, Empirical14Strategy, and Results, checking that the estimand is defined, the assumption15stated, the magnitudes interpreted, and the prose matched to the tables. Draft16the body **before** the introduction — the introduction summarizes a paper that17already exists, and writing it first produces promises the body fails to keep.1819## When to Use2021- The empirics are stable (after `aer-identification` and `aer-robustness`)22 and the manuscript needs full section drafts23- A results section reads like a table walk-through ("Column 1 shows...") and24 needs narration surgery25- A referee called the paper "hard to follow," "under-interpreted," or "reads26 like a report"27- Coefficients are reported but never converted into economic magnitudes28- The conclusion restates the abstract and needs to do real work2930## Canonical Section Architecture3132A full-length empirical AER paper, after the unlabeled introduction:3334```35I. Background (or: Institutional Setting; Policy Context)36II. Data (sources, sample construction, measurement, summary stats)37III. Empirical Strategy (estimand, equation, identifying assumption, inference)38IV. Results (main estimates, dynamics, robustness pointers)39V. Mechanisms (or: Heterogeneity and Mechanisms; Interpretation)40VI. Conclusion41```4243Variants: a **conceptual framework** goes between Background and Data (or44replaces Background for theory-led papers); *AER: Insights* compresses to Data45and Design → Results → Discussion; structural papers add Model and Estimation,46where the rules below bind with more force, not less. One rule binds47everywhere: **every term, dataset, and design feature is defined before first48use** — referees read linearly on the first pass.4950## Section I — Background / Institutional Setting5152Give exactly the institutional detail needed to (a) locate the identifying53variation and (b) believe the identifying assumption — nothing else.5455- Lead with the institution or policy, not the literature. History belongs56 here only if it explains the variation.57- State **who is treated, when, by what rule, and who decided**. If assignment58 is discretionary, say so and explain how the design handles it.59- Length 1.5-3 typeset pages; surplus is almost always literature review in60 disguise — cut it or move it to the intro's antecedents paragraph.61- Cite a **primary source** (statute, agency document, administrative report)62 for every institutional claim, not a secondhand economics paper.6364## Optional Section — Conceptual Framework6566Include one only if it generates a testable prediction the empirics then test,67defines the estimand's welfare interpretation (a reduced-form coefficient as a68sufficient statistic), or disciplines magnitudes (what effect size theory69permits).7071- Keep it **stylized** — two-period, two-type, linear where possible. Push72 derivations to the appendix; state propositions and intuition in the text.73- End with an explicit bridge naming the predictions taken to the data; each74 must reappear, by name, in Results or Mechanisms.75- Do not bolt on a model that re-derives "demand slopes down." Referees read76 decorative theory as padding and say so.7778## Section II — Data7980Referees check this section against the replication package line by line.8182- **Sources.** For each dataset: name, producer, access mode, years, unit of83 observation, and a citation. If access is restricted, say how it was obtained84 (this feeds `aer-replication`).85- **Sample construction** — the most under-written block in rejected papers.86 Report the funnel explicitly with counts (raw file → each drop with its count87 and rationale → analysis sample). Counts must match the replication package88 exactly (`aer-consistency` audits this); flag consequential restrictions the89 robustness section relaxes.90- **Variables and measurement.** Define outcome and treatment precisely, with91 units, in prose (the full variable table lives in the appendix). Discuss92 measurement error where a referee would: self-reports, imputation,93 top-coding, deflators (name the index and base year). State the level of94 aggregation and why it matches the design.95- **Summary statistics.** Narrate Table 1, do not re-read it aloud. Two to four96 facts, each tied to a design decision: is the sample representative, are the97 groups comparable pre-treatment, and what features (skewness, mass points,98 attrition) shape specification choices.99100## Section III — Empirical Strategy101102The section referees read most carefully. Four mandatory components, in order:103**estimand → equation → identifying assumption → inference**.104105**Estimand first**, one sentence before any equation: "Our object of interest106is the average effect of [treatment] on [outcome] among [population],107[horizon]." If the design recovers a local effect (LATE, effect at the cutoff,108ATT for switchers), say so here, not in the conclusion's limitations paragraph.109110```latex111Y_{ict} = \beta\, D_{ct} + \alpha_c + \gamma_t + X_{ict}'\delta + \varepsilon_{ict}112```113114- **Define every symbol** in the sentence after the equation, every subscript115 included (what each index ranges over; what $D_{ct}$ codes). Keep subscript116 order consistent across equations and tables. Number displayed equations;117 refer to "equation (1)."118- State which coefficient is the object of interest and what variation119 identifies it once controls and fixed effects absorb the rest.120- For modern DiD, write the ATT(g,t) estimand and aggregation explicitly rather121 than pretending the design is equation-(1) TWFE — the estimator choice comes122 from `aer-identification`.123- **Identifying assumption:** state it formally **and** in words, then preview124 the evidence. The unit of writing is "assumption — threat — evidence"; name125 the two or three most plausible violations and point to where each is met.126- **Inference:** one paragraph — clustering level and why it matches the127 design's variation, number of clusters, and any small-cluster correction128 (wild cluster bootstrap) or design-specific inference (AR confidence sets,129 randomization inference). Never leave inference to the table notes alone.130131## Section IV — Results132133### The narration discipline134135One paragraph per claim, not per table. Each results paragraph:1361371. **Finding first.** The opening sentence states the economic finding with its138 magnitude, not the table's existence: "The reform raises earnings by 4.2139 percent (Table 3, column 4)," never "Table 3 presents the results."1402. **Evidence.** Where the number comes from and how it moves across141 specifications (added controls, finer fixed effects, alternative samples).1423. **Interpretation.** Convert the coefficient into economic units and143 benchmark it.144145Column-by-column narration without a finding-first sentence is the most146reliable marker of a weak results section.147148### Magnitude interpretation149150Every headline coefficient gets three conversions: (1) **native units** —151log-outcome coefficients are *log points*; use the exact 100·(e^β − 1) whenever152|β| > 0.10, and never confuse **percent** with **percentage points**; (2)153**relative to the sample** — against the dependent variable's mean or SD; (3)154**relative to the literature or a policy lever**. Report the baseline rate next155to every binary marginal effect. If the implied magnitude is implausible, say156so and investigate before a referee does. Worked conversions:157`examples/results-section-example.md`; the percent/percentage-point table lives158in `aer-consistency`.159160### Precision and back-of-envelope161162- Quote point estimates and standard errors **exactly** as the table shows163 them. "Significant at the 5 percent level," never "almost significant." For164 nulls, report the CI and what it rules out, distinguishing a precise zero165 from an uninformative one. Line-level rules: `docs/style-guide.md`.166- Close a high-impact results section with **one** disciplined aggregate167 calculation: every input and its source stated, multiplied through in one168 visible chain, rounded honestly — not a cascade of unsourced products. If it169 needs more than a paragraph, it becomes its own short section. Worked170 example: `examples/results-section-example.md`.171172### Robustness pointers173174The results section **cites** robustness, it does not contain it: one paragraph175summarizing the `aer-robustness` battery ("stable across clustering, sample,176and specification variants; Appendix B reports the full set") plus the single177most important check shown inline.178179## Section V — Mechanisms180181Organize by **candidate explanation**, not by table:1821831. Name the two or three channels consistent with the main result, including184 the ones you will rule out.1852. For the favored channel, present the theory-predicted heterogeneity and186 auxiliary outcomes ("if the channel is skill-biased adoption, effects should187 concentrate in tradeable services — they do, Table 5").1883. For each alternative, state the sharpest version of the referee's objection,189 then the evidence against it. Steelman first, then answer.1904. Close with calibrated language ("most consistent with [channel]," not "we191 prove the mechanism"). Mechanism evidence is consistency evidence; only the192 main effect carries design-based identification (see `aer-identification`).193194## Section VI — Conclusion195196Short (half a page to one page), doing four things:1971981. Restate the question and the headline magnitude in fresh words — no abstract199 sentences copied verbatim (`aer-consistency` flags duplication).2002. State the external-validity boundary: population, period, policy margin, and201 the complier/locality caveat if the design implies one.2023. Draw the one policy or theory implication the evidence supports — one step203 beyond the results, never three.2044. At most two sentences on specific open questions this paper makes205 answerable, not "more research is needed."206207No new results, no new citations, no new caveats that belong in Results.208209## Cross-Section Consistency Rules210211- The introduction's promises (contributions, magnitudes, evidence) map212 one-to-one onto body sections; nothing promised is undelivered and nothing213 major appears unannounced.214- Numbers, sample sizes, and specification labels match the tables exactly215 everywhere — `aer-consistency` audits this before submission.216- Tense: present for what the paper does and finds; past for data collection217 and historical events.218- Prose follows `docs/style-guide.md` — finding-first sentences, no filler219 transitions, no AI-pattern tics.220221## Repository Resources222223Bundled with the installed skill, no repository checkout needed --- read it224before the repo resources below:225226- `references/section-skeletons.md` --- per-section skeletons and conclusion-first results narration rules227228Load only the relevant resource:229230- Worked results-section narration (same fictional paper as the intro example):231 `examples/results-section-example.md`232- Sentence- and paragraph-level prose rules: `docs/style-guide.md`233- Estimator, diagnostic, and citation defaults for Section III:234 `docs/methods-reference.md`235- Model introduction the body must stay consistent with:236 `examples/intro-example.md`237- Code that should produce every number quoted in Results: `templates/stata/`,238 `templates/r/`, or `templates/python/`239240## Handoff241242```text243SECTIONS DRAFTED: <Background | Framework | Data | Strategy | Results | Mechanisms | Conclusion>244ESTIMAND STATED: <yes / no — sentence>245SAMPLE FUNNEL REPORTED: <yes / no>246HEADLINE MAGNITUDE CONVERSIONS: <log-points / percent / vs-mean / vs-literature>247BACK-OF-ENVELOPE CALCULATION: <present / not applicable>248MECHANISM CHANNELS: <favored + ruled-out list>249NEXT SKILL: <aer-introduction | aer-tables-figures | aer-consistency>250```251252## Anti-Patterns253254- Writing the introduction first and forcing the body to keep its promises255- Narrating tables instead of findings ("Table 4 shows the results. Column 1256 reports...")257- Reporting a 0.31 log-point effect as "31 percent" (it is 36 percent), or258 never benchmarking the magnitude at all259- The estimand defined nowhere — "the effect" means three populations in three260 sections261- The sample funnel absent, so the referee reconstructs (and mistrusts) the Ns262- A conceptual framework added after the results to decorate them263- Mechanisms organized as "more regressions," or claimed with the confidence of264 the identified main effect265- A two-page conclusion introducing limitations Results hid, or paragraphs266 recycled verbatim into the abstract267- Institutional background with no source for any factual claim