/aejpol-writing-style
Use when drafting or revising the prose of an AEJ: Economic Policy manuscript — especially the abstract and introduction — to translate causal estimates into a clear policy takeaway without overclaiming. Shapes the policy-first narrative and house style; it does not design
$ npx -y skills add brycewang-stanford/Awesome-Journal-Skills --skill aejpol-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
/aejpol-writing-style
Context preview
The summary Claude sees to decide when to auto-load this skill.
Use when drafting or revising the prose of an AEJ: Economic Policy manuscript — especially the abstract and introduction — to translate causal estimates into a clear policy takeaway without overclaiming. Shapes the policy-first narrative and house style; it does not design
SKILL.md
aejpol-writing-style.SKILL.mdname: aejpol-writing-style
description: Use when drafting or revising the prose of an AEJ: Economic Policy manuscript — especially the abstract and introduction — to translate causal estimates into a clear policy takeaway without overclaiming. Shapes the policy-first narrative and house style; it does not design identification or build the welfare model.
Writing Style — From Estimate to Policy Takeaway (aejpol-writing-style)
When to trigger
- The intro buries the policy question under data or method
- The abstract reports a coefficient but no policy lesson
- The paper has a clean estimate but no sentence a policymaker could act on — or it overclaims
- You are polishing for submission and need AEA house tone
> Late-stage polish: do not rewrite the intro until identification (`aejpol-identification`), the welfare bridge (`aejpol-theory-model`), and robustness (`aejpol-robustness`) have settled.
The AEJ: Policy introduction arc
**Policy question → why credible identification is hard → the design that delivers it → headline causal estimate (with SE/CI) → welfare / cost-benefit / distributional reading → concrete, calibrated policy lesson → brief roadmap.**
The distinctive moves vs. a general applied-micro intro:
1. **Open with the policy question, not the dataset or estimator.** A non-specialist AEA reader should know within two sentences what policy is at stake and why the answer matters. 2. **Put the headline estimate, with its uncertainty, on page one** — in policy-interpretable units (a percentage-point effect, a cost-per-outcome), never an asterisk. 3. **Translate into a policy takeaway** — the cost-benefit / MVPF / incidence reading — and state it as the contribution. 4. **Calibrate the claim.** Say exactly what the estimand is, for whom, and the conditions under which the lesson holds. The credibility of an AEJ: Policy paper rests as much on *not overclaiming* as on the estimate.
Translating estimates into policy language without overclaiming
- Convert coefficients into decision-relevant quantities ("a $1,000 expansion raises take-up by X and costs $Y per additional recipient") rather than leaving them as elasticities.
- Tie magnitude to a benchmark a policymaker recognizes (the program's budget, the status-quo level, a comparable policy).
- **Hedge precisely, not vaguely:** state the population the estimate applies to, the time horizon, and the assumptions the welfare reading needs. Replace "this shows policy X is good" with "for this population and horizon, the marginal dollar of X returns $Z, assuming [stated condition]."
- Separate what the data show (the causal estimate) from what the framework adds (the welfare reading) so a referee can grant one without the other.
AEA house style
- Author–year citations; SEs/CIs not asterisks (mirror `aejpol-tables-figures`); active voice; abstract that states question, design, headline estimate, and policy lesson. Online appendix carries the long material; the main text stays self-contained and readable. Review is single-blind, so the front matter names the authors — no need to anonymize the prose.
Checklist
- [ ] First two sentences state the policy question and why it matters
- [ ] Headline estimate with SE/CI appears early, in policy-interpretable units
- [ ] A one-sentence policy takeaway (cost-benefit / MVPF / incidence) is stated as the contribution
- [ ] The claim is calibrated: population, horizon, and assumptions named
- [ ] Causal estimate and welfare reading are separable in the prose
- [ ] No significance asterisks; author–year citations; abstract carries the policy lesson
- [ ] Self-citations cited normally (single-blind — no anonymization needed)
Anti-patterns
- An intro that leads with the dataset, the institutional weeds, or the estimator
- An abstract that ends at the coefficient with no policy lesson
- Overclaiming ("our results prove policy X should be adopted nationwide") beyond the estimand
- Vague hedging ("results should be interpreted with caution") instead of a precise scope statement
- Burying the policy takeaway in the conclusion where a policymaker will not find it
- Padding the prose with self-citations to signal a track record (cite only what the argument needs)
Worked vignette (illustrative)
Before: "Using administrative data and a difference-in-differences design, we estimate the effect of the reform on enrollment; the coefficient is 0.06 (s.e. 0.01)." After (AEJ: Policy): "Does auto-enrollment raise retirement-plan participation enough to justify its administrative cost? Exploiting the staggered rollout across employers, we find auto-enrollment raises participation by 6 percentage points (90% CI [4, 8]). At the program's per-worker cost this implies roughly $X per additional participant — cost-effective relative to a matching subsidy for this low-saver population, though the gain is concentrated among workers who would not have opted in (illustrative)." Question first, estimate with CI, policy lesson, calibrated scope.
Output format
【Opening policy question】one sentence
【Headline estimate】value + SE/CI in policy units, stated early
【Policy takeaway】cost-benefit / MVPF / incidence sentence
【Calibration】population + horizon + assumptions named
【Overclaim check】claim ≤ what design+framework support? [Y/N]
【Next step】aejpol-replication-package or aejpol-referee-strategy
Read more
name: aejpol-writing-style description: Use when drafting or revising the prose of an AEJ: Economic Policy manuscript — especially the abstract and introduction — to translate causal estimates into a clear policy takeaway without overclaiming. Shapes the policy-first narrative and house style; it does not design identification or build the welfare model.
Writing Style — From Estimate to Policy Takeaway (aejpol-writing-style)
When to trigger
- The intro buries the policy question under data or method
- The abstract reports a coefficient but no policy lesson
- The paper has a clean estimate but no sentence a policymaker could act on — or it overclaims
- You are polishing for submission and need AEA house tone
> Late-stage polish: do not rewrite the intro until identification (`aejpol-identification`), the welfare bridge (`aejpol-theory-model`), and robustness (`aejpol-robustness`) have settled.
The AEJ: Policy introduction arc
**Policy question → why credible identification is hard → the design that delivers it → headline causal estimate (with SE/CI) → welfare / cost-benefit / distributional reading → concrete, calibrated policy lesson → brief roadmap.**
The distinctive moves vs. a general applied-micro intro:
1. **Open with the policy question, not the dataset or estimator.** A non-specialist AEA reader should know within two sentences what policy is at stake and why the answer matters. 2. **Put the headline estimate, with its uncertainty, on page one** — in policy-interpretable units (a percentage-point effect, a cost-per-outcome), never an asterisk. 3. **Translate into a policy takeaway** — the cost-benefit / MVPF / incidence reading — and state it as the contribution. 4. **Calibrate the claim.** Say exactly what the estimand is, for whom, and the conditions under which the lesson holds. The credibility of an AEJ: Policy paper rests as much on *not overclaiming* as on the estimate.
Translating estimates into policy language without overclaiming
- Convert coefficients into decision-relevant quantities ("a $1,000 expansion raises take-up by X and costs $Y per additional recipient") rather than leaving them as elasticities.
- Tie magnitude to a benchmark a policymaker recognizes (the program's budget, the status-quo level, a comparable policy).
- **Hedge precisely, not vaguely:** state the population the estimate applies to, the time horizon, and the assumptions the welfare reading needs. Replace "this shows policy X is good" with "for this population and horizon, the marginal dollar of X returns $Z, assuming [stated condition]."
- Separate what the data show (the causal estimate) from what the framework adds (the welfare reading) so a referee can grant one without the other.
AEA house style
- Author–year citations; SEs/CIs not asterisks (mirror `aejpol-tables-figures`); active voice; abstract that states question, design, headline estimate, and policy lesson. Online appendix carries the long material; the main text stays self-contained and readable. Review is single-blind, so the front matter names the authors — no need to anonymize the prose.
Checklist
- [ ] First two sentences state the policy question and why it matters
- [ ] Headline estimate with SE/CI appears early, in policy-interpretable units
- [ ] A one-sentence policy takeaway (cost-benefit / MVPF / incidence) is stated as the contribution
- [ ] The claim is calibrated: population, horizon, and assumptions named
- [ ] Causal estimate and welfare reading are separable in the prose
- [ ] No significance asterisks; author–year citations; abstract carries the policy lesson
- [ ] Self-citations cited normally (single-blind — no anonymization needed)
Anti-patterns
- An intro that leads with the dataset, the institutional weeds, or the estimator
- An abstract that ends at the coefficient with no policy lesson
- Overclaiming ("our results prove policy X should be adopted nationwide") beyond the estimand
- Vague hedging ("results should be interpreted with caution") instead of a precise scope statement
- Burying the policy takeaway in the conclusion where a policymaker will not find it
- Padding the prose with self-citations to signal a track record (cite only what the argument needs)
Worked vignette (illustrative)
Before: "Using administrative data and a difference-in-differences design, we estimate the effect of the reform on enrollment; the coefficient is 0.06 (s.e. 0.01)." After (AEJ: Policy): "Does auto-enrollment raise retirement-plan participation enough to justify its administrative cost? Exploiting the staggered rollout across employers, we find auto-enrollment raises participation by 6 percentage points (90% CI [4, 8]). At the program's per-worker cost this implies roughly $X per additional participant — cost-effective relative to a matching subsidy for this low-saver population, though the gain is concentrated among workers who would not have opted in (illustrative)." Question first, estimate with CI, policy lesson, calibrated scope.
Output format
【Opening policy question】one sentence 【Headline estimate】value + SE/CI in policy units, stated early 【Policy takeaway】cost-benefit / MVPF / incidence sentence 【Calibration】population + horizon + assumptions named 【Overclaim check】claim ≤ what design+framework support? [Y/N] 【Next step】aejpol-replication-package or aejpol-referee-strategy
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

