/aeja-writing-style
Use when revising the prose, abstract, and introduction of an American Economic Journal: Applied Economics (AEJ: Applied) manuscript so the design and headline estimate land in the first paragraph in AEA house style. Polishes exposition; it does not change the result
$ npx -y skills add brycewang-stanford/Awesome-Journal-Skills --skill aeja-writing-style --agent claude-codeHow it fires
How this skill gets triggered: by you, by Claude, or both.
- Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.Auto-invocation is when the right skill fires by itself at the right moment, driven by a FLOW.md router and a hook, instead of you invoking it by name. It is the difference between a skill being installed and a skill actually getting used.Read the full definition →
- You can call itInvoke it directly when you want it.
- Slash command
/aeja-writing-style
Context preview
The summary Claude sees to decide when to auto-load this skill.
Use when revising the prose, abstract, and introduction of an American Economic Journal: Applied Economics (AEJ: Applied) manuscript so the design and headline estimate land in the first paragraph in AEA house style. Polishes exposition; it does not change the result
SKILL.md
aeja-writing-style.SKILL.mdname: aeja-writing-style
description: Use when revising the prose, abstract, and introduction of an American Economic Journal: Applied Economics (AEJ: Applied) manuscript so the design and headline estimate land in the first paragraph in AEA house style. Polishes exposition; it does not change the result (aeja-identification / aeja-robustness) or the exhibits.
Writing Style (aeja-writing-style)
When to trigger
- Identification and robustness are settled and the paper needs its final exposition pass
- The introduction buries the question and the estimate under setup or literature
- The abstract does not state the headline number with its uncertainty
- The prose reads like a field-internal note rather than broad applied micro
The AEJ: Applied introduction arc
AEJ: Applied prose is **plain, direct, and design-forward**. The introduction should follow the applied-micro arc: **question → why credible identification is hard → the design that solves it → headline causal estimate with a standard error → mechanism → policy/economic lesson → brief roadmap.** A non-specialist applied economist should grasp the question and the answer in the first paragraph; the design should be legible by the end of the second.
| Section | What it must do at AEJ: Applied | |---------|--------------------------------| | Abstract | question + design + headline estimate (with units & SE) + lesson, in ≤ the AEA word norm | | Intro ¶1 | the economic question and the headline number, with uncertainty, no throat-clearing | | Intro ¶2–3 | why naive estimates fail + the source of variation that fixes it | | Intro mid | the estimate, the mechanism, and the magnitude's economic meaning | | Intro end | contribution (honest delta), scope of the claim, brief roadmap |
Writing craft
1. **Lead with the answer, not the setup.** The first paragraph states what you find and roughly how big; the apparatus comes after. 2. **Numbers with units and SEs in sentences.** "We find X raises Y by 6.2% (s.e. 0.7)" — the magnitude lives in the prose, not only the table. 3. **Name the design plainly.** "We use a regression discontinuity at the eligibility cutoff" beats euphemism; AEJ: Applied readers want the identification stated. 4. **Calibrate the claim.** State what the estimand is (local / ITT) and what it does *not* establish — over-claiming external validity is a frequent referee complaint. 5. **Plain English over jargon.** Short sentences; active voice; define field-specific terms once. Broad applied-micro readership is the audience. 6. **Write the abstract and intro last**, after the result is final.
Checklist
- [ ] Abstract states question + design + headline estimate (units & SE) + lesson, within the AEA word norm
- [ ] Intro ¶1 gives the economic question and the headline number with uncertainty — no throat-clearing
- [ ] The naive-estimate problem and the identifying variation appear by ¶2–3
- [ ] Magnitudes written into sentences with units and standard errors
- [ ] Estimand and scope stated; external-validity claim calibrated, not inflated
- [ ] Plain English, active voice, jargon defined once; abstract/intro written last
Anti-patterns
- An introduction that spends a page on institutional background before stating the question
- A "literature tour" intro with no contribution sentence up front (see `aeja-literature-positioning`)
- Reporting "statistically significant" without the magnitude, units, or SE in the prose
- Over-claiming the local/ITT estimate as a general population effect
- Jargon-dense, passive-voice writing aimed only at sub-field specialists
- Polishing the intro before identification and robustness are settled
Worked vignette (illustrative)
A first-draft intro opens with a page of institutional background on a transit program, then a TWFE specification, then "the effect is statistically significant." The AEJ: Applied rewrite leads with the answer: "Does cheap transportation help teenagers find work? Using a staggered municipal rollout of free bus passes, we find the program raised teen employment by 3.1 percentage points (s.e. 0.9)." The design is named in the next sentence, the mechanism and the calibrated scope follow, and the institutional detail moves to Section 2. The full before→after is in [`../../resources/worked-examples/01-introduction.md`](../../resources/worked-examples/01-introduction.md).
Referee pushback mapped to the writing fix
- *"I read three pages before learning what you find."* → Move the headline number and design to ¶1; demote
background to the data section.
- *"You report significance but not the magnitude."* → Put the point estimate, its units, and its SE in the
sentence, not only the table.
- *"You overclaim external validity."* → State the estimand (local/ITT) and what it does not establish.
Output format
【Abstract】question + design + estimate(units,SE) + lesson within word norm? [Y/N]
【Intro ¶1】headline number + uncertainty up front? [Y/N]
【Identification legible by ¶3】[Y/N]
【Magnitudes in prose】units + SEs in sentences? [Y/N]
【Claim calibrated】estimand + scope stated, no overclaim? [Y/N]
【Next step】aeja-replication-package
Read more
name: aeja-writing-style description: Use when revising the prose, abstract, and introduction of an American Economic Journal: Applied Economics (AEJ: Applied) manuscript so the design and headline estimate land in the first paragraph in AEA house style. Polishes exposition; it does not change the result (aeja-identification / aeja-robustness) or the exhibits.
Writing Style (aeja-writing-style)
When to trigger
- Identification and robustness are settled and the paper needs its final exposition pass
- The introduction buries the question and the estimate under setup or literature
- The abstract does not state the headline number with its uncertainty
- The prose reads like a field-internal note rather than broad applied micro
The AEJ: Applied introduction arc
AEJ: Applied prose is **plain, direct, and design-forward**. The introduction should follow the applied-micro arc: **question → why credible identification is hard → the design that solves it → headline causal estimate with a standard error → mechanism → policy/economic lesson → brief roadmap.** A non-specialist applied economist should grasp the question and the answer in the first paragraph; the design should be legible by the end of the second.
| Section | What it must do at AEJ: Applied | |---------|--------------------------------| | Abstract | question + design + headline estimate (with units & SE) + lesson, in ≤ the AEA word norm | | Intro ¶1 | the economic question and the headline number, with uncertainty, no throat-clearing | | Intro ¶2–3 | why naive estimates fail + the source of variation that fixes it | | Intro mid | the estimate, the mechanism, and the magnitude's economic meaning | | Intro end | contribution (honest delta), scope of the claim, brief roadmap |
Writing craft
1. **Lead with the answer, not the setup.** The first paragraph states what you find and roughly how big; the apparatus comes after. 2. **Numbers with units and SEs in sentences.** "We find X raises Y by 6.2% (s.e. 0.7)" — the magnitude lives in the prose, not only the table. 3. **Name the design plainly.** "We use a regression discontinuity at the eligibility cutoff" beats euphemism; AEJ: Applied readers want the identification stated. 4. **Calibrate the claim.** State what the estimand is (local / ITT) and what it does *not* establish — over-claiming external validity is a frequent referee complaint. 5. **Plain English over jargon.** Short sentences; active voice; define field-specific terms once. Broad applied-micro readership is the audience. 6. **Write the abstract and intro last**, after the result is final.
Checklist
- [ ] Abstract states question + design + headline estimate (units & SE) + lesson, within the AEA word norm
- [ ] Intro ¶1 gives the economic question and the headline number with uncertainty — no throat-clearing
- [ ] The naive-estimate problem and the identifying variation appear by ¶2–3
- [ ] Magnitudes written into sentences with units and standard errors
- [ ] Estimand and scope stated; external-validity claim calibrated, not inflated
- [ ] Plain English, active voice, jargon defined once; abstract/intro written last
Anti-patterns
- An introduction that spends a page on institutional background before stating the question
- A "literature tour" intro with no contribution sentence up front (see `aeja-literature-positioning`)
- Reporting "statistically significant" without the magnitude, units, or SE in the prose
- Over-claiming the local/ITT estimate as a general population effect
- Jargon-dense, passive-voice writing aimed only at sub-field specialists
- Polishing the intro before identification and robustness are settled
Worked vignette (illustrative)
A first-draft intro opens with a page of institutional background on a transit program, then a TWFE specification, then "the effect is statistically significant." The AEJ: Applied rewrite leads with the answer: "Does cheap transportation help teenagers find work? Using a staggered municipal rollout of free bus passes, we find the program raised teen employment by 3.1 percentage points (s.e. 0.9)." The design is named in the next sentence, the mechanism and the calibrated scope follow, and the institutional detail moves to Section 2. The full before→after is in [`../../resources/worked-examples/01-introduction.md`](../../resources/worked-examples/01-introduction.md).
Referee pushback mapped to the writing fix
- *"I read three pages before learning what you find."* → Move the headline number and design to ¶1; demote
background to the data section.
- *"You report significance but not the magnitude."* → Put the point estimate, its units, and its SE in the
sentence, not only the table.
- *"You overclaim external validity."* → State the estimand (local/ITT) and what it does not establish.
Output format
【Abstract】question + design + estimate(units,SE) + lesson within word norm? [Y/N] 【Intro ¶1】headline number + uncertainty up front? [Y/N] 【Identification legible by ¶3】[Y/N] 【Magnitudes in prose】units + SEs in sentences? [Y/N] 【Claim calibrated】estimand + scope stated, no overclaim? [Y/N] 【Next step】aeja-replication-package
Stanford REAP × CoPaper.AI · 由斯坦福实证方法论团队精选与维护 访问 copaper.ai 微信:CoPaper.AI 按 11 个主流学科板块覆盖 经管与商科 社会科学 人文学科 数学与物理科学 生命科学 医学与健康 工程与技术 计算机科学与 AI 体育科学 点击任一学科名可跳转到对应说明;每类下的代表子领域在正文总览中完整列出。下方封面墙按 venue 导航,完整分类见覆盖一览。 🧭 布局指南 · 📚 Skill Pack 一览 · ⚡ 如何使用 · 🧪 自动实证
Other skills on awesome-journal-skills.
- /aaai-artifact-evaluation
Use when packaging AAAI code, data, multimedia appendices, technical appendices, reproducibility evidence, and post-acceptance artifact releases without violating double-blind or immutable-supplement rules.
Open skill - /aaai-author-response
Use when drafting an AAAI author response (rebuttal) under the single short character-limited author-feedback window, the no-URL rule, no-new-results guidance, AI-generated-review handling, and the AAAI two-phase review process where Phase-2 papers receive one feedback round
Open skill - /aaai-camera-ready
Use when preparing an accepted AAAI paper for camera-ready source submission to AAAI Press, including proceedings page limits, two-column template compliance, copyright transfer, purchased extra technical pages, deanonymization, registration, oral or poster presentation, and
Open skill - /aaai-experiments
Use when designing or auditing AAAI experiments for the broad-AI program committee, including baselines, ablations, statistical significance, robustness, human evaluation, AI-for-Social-Impact and alignment/safety evidence, compute and cost reporting, and
Open skill - /aaai-related-work
Use when positioning an AAAI paper's novelty against archival work, contemporaneous arXiv or workshop papers, and AAAI/IJCAI/NeurIPS/ICML/ICLR neighbors across the broad AI scope, while staying inside AAAI's dual-submission and AI-as-source policy constraints and writing a
Open skill - /aaai-reproducibility
Use when strengthening an AAAI paper's reproducibility checklist (placed after references), experimental traceability, seed and hyperparameter reporting, compute and cost disclosure, dataset access and licensing, code/data ZIP readiness, and the claim-to-evidence map that
Open skill

