Skip to content
Content
Skill

/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

From plugin
awesome-journal-skills
1.3k200 skills

Claude Code

$ npx -y skills add brycewang-stanford/Awesome-Journal-Skills --skill aejpol-writing-style --agent claude-code

SKILL.md

aejpol-writing-style.SKILL.md
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
Read more
@brycewang-stanford
Ships withawesome-journal-skills

Stanford REAP × CoPaper.AI · 由斯坦福实证方法论团队精选与维护 访问 copaper.ai 微信:CoPaper.AI 按 11 个主流学科板块覆盖 经管与商科 社会科学 人文学科 数学与物理科学 生命科学 医学与健康 工程与技术 计算机科学与 AI 体育科学 点击任一学科名可跳转到对应说明;每类下的代表子领域在正文总览中完整列出。下方封面墙按 venue 导航,完整分类见覆盖一览。 🧭 布局指南 · 📚 Skill Pack 一览 · ⚡ 如何使用 · 🧪 自动实证

1.3k200 skills
Get the whole plugin

Stars on GitHub

Momentum

stars in total
1.3k
Star history of brycewang-stanford/Awesome-Journal-Skills on GitHub, a chart by star-history.com

Other skills on awesome-journal-skills.

More skills from other plugins.

prompt-lookup

prompt-lookup

Activates when the user asks about AI prompts, needs prompt templates, wants to search for prompts, or mentions prompts.chat. Use…

@gh-f@gh-fInstall Skill
ppt-master

ppt-master

AI-driven presentation workflow for generating editable PPTX decks and slides, reconstructing page visuals, creating reusable…

@hugohe3@hugohe3Install Skill
morph-ppt

morph-ppt

Use this skill when the user wants a .pptx with smooth cross-slide animation — PowerPoint Morph transitions, Keynote-style…

officecli12d33k
@iofficeai@iofficeaiInstall Skill

Questions about aejpol-writing-style.

Which coding agents can use aejpol-writing-style?
aejpol-writing-style installs in Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode and Windsurf with the skills CLI, using each agent's flag shown on this page. Flowy's auto-invocation, which fires a skill when your prompt matches, runs in Claude Code only.