Use when revising sentence-level voice and the abstract/opening for a Journal of Economic Perspectives (JEP) article — engaging, clear, authoritative-but-readable, minimal notation. Polishes prose and front matter; defer structure to jep-narrative-arc and evidence framing to jep-evidence-without-equations.
Scanned 9/5/2026
Install to Claude Code
npx -y skills add brycewang-stanford/Awesome-Journal-Skills --skill jep-writing-style --agent claude-codeInstalls into .claude/skills of the current project.
Are you the author of Jep Writing Style?
Add the live security badge to your README — it updates automatically with every re-scan.
[](https://www.skillsdirectory.com/skills/brycewang-stanford-jep-writing-style)More formats (shields.io, HTML) on the badges page.
---
name: jep-writing-style
description: Use when revising sentence-level voice and the abstract/opening for a Journal of Economic Perspectives (JEP) article — engaging, clear, authoritative-but-readable, minimal notation. Polishes prose and front matter; defer structure to jep-narrative-arc and evidence framing to jep-evidence-without-equations.
---
# JEP Writing Style (jep-writing-style)
## When to trigger
- The argument and balance are settled and the prose needs to land
- The abstract reads like a research-paper abstract (machinery, results, no hook)
- Sentences are passive, hedged, and dense; the voice is dull
- Notation or asterisks have crept back into otherwise accessible prose
## The JEP voice
JEP prose is **engaging, clear, and authoritative-but-readable** — the famous "no abstract math in the body" feel. It sounds like a knowledgeable economist explaining something fascinating to a smart colleague from another field: confident, plain, and never showing off. Run this *after* the narrative arc and balance are set; voice polish before structure is wasted.
## Sentence-level rules
- **Active voice and plain verbs.** "We find" / "The data show" / "Firms respond" — not "It is found that responses were observed."
- **Short, varied sentences.** Break long compound sentences. A short sentence after a long one lands a point.
- **Concrete nouns; few abstractions.** "Grocery prices" beats "the price level in the relevant sector."
- **No notation in the body.** Symbols, equations, and asterisks belong in a note/appendix at most (mirrors `jep-accessibility-and-translation`).
- **Earn the jargon.** Define on first use or cut; never use a term to sound rigorous.
- **Confidence without hype.** State what is known plainly; avoid both timid over-hedging and breathless over-claiming.
- **Lead paragraphs with the point.** Topic sentence first, then support — readers should get the gist by skimming openers.
## The abstract and opening
- **Abstract:** plain-language, hook-forward — what question, what we now understand, why it matters. No estimating equations, no asterisks, no method-flexing. JEP applies AEA house style at copyediting, so write for *clarity*, not pre-formatting (re-confirm current abstract guidance on the official page; 检索于 2026-06).
- **Opening lines:** the hook from `jep-narrative-arc` (a puzzle, a fact, a vivid example, a live debate), never "The literature on X has grown rapidly."
- **First page test:** a non-specialist economist should know the question, why it matters, and roughly the answer by the bottom of page one.
## House-style notes (verify on the official AEA pages)
- AEA house style is applied by the copyeditor at acceptance; the submitted manuscript need not pre-conform — write for readability.
- JEL codes and an abstract are part of AEA front matter (re-confirm exact JEP requirements; 检索于 2026-06;以官网为准).
- References are part of the synthesis, not a flex — cite what carries the argument and the further-reading value, consistent with JEP's broad-audience role.
## Checklist
- [ ] Active voice; plain verbs; varied, mostly short sentences
- [ ] No equations, symbols, or significance asterisks in the body
- [ ] Every term earns its place (defined on first use or cut)
- [ ] Confident but not hyped; not over-hedged
- [ ] Paragraphs lead with the point
- [ ] Abstract is plain-language and hook-forward (no machinery)
- [ ] First page conveys question + stakes + rough answer
- [ ] Front matter (abstract / JEL / keywords) checked against current AEA guidance
## Anti-patterns
- A research-paper abstract ("We estimate… using… and find a coefficient of…")
- Opening with the literature or with definitions
- Passive, hedged, abstraction-heavy sentences that bury the idea
- Notation or asterisks surviving into the body "for precision"
- Showing off command of the field instead of explaining it
- Over-claiming certainty the evidence doesn't support (also a balance failure)
## Output format
```
【Voice pass】active / plain / varied sentences? [Y/N]
【Body math/asterisks】removed? [Y/N]
【Abstract】plain-language, hook-forward, no machinery? [Y/N]
【Opening hook】[puzzle / fact / example / debate]
【First-page test】question + stakes + rough answer by p.1? [Y/N]
【Front matter】abstract / JEL / keywords per AEA guidance? [Y/N]
【Next step】jep-balance-and-objectivity
```
Is this your skill, or is something wrong with this listing? Request removal or report an issue. Author removals are honored within 72 hours.
No comments yet. Be the first to comment!