Agent skill · Documentation

jep-writing-style

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.

brycew6m878★ · +32/wk · 1 repos on radarProfile →
claude-codeMIT
Install
npx skills add brycewang-stanford/Awesome-Journal-Skills --skill jep-writing-style --agent claude-code

Same command for any agent — swap --agent for codex, cursor, copilot.

Facts
Files in the skill folder: 1
SKILL.md size: 4 KB
Bundled scripts: none
Path: Journal-of-Economic-Perspectives-Skills/skills/jep-writing-style/SKILL.md
Open the folder on GitHub →
Where it comes from
Stars: 909 · +31 this week
Language: Stata
Read our review of the source →

Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.

From the SKILL.md

# 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 (m

What's inside
Steps it walks through
  1. When to trigger
  2. The JEP voice
  3. Sentence-level rules
  4. The abstract and opening
  5. House-style notes (verify on the official AEA pages)
  6. Checklist
  7. Anti-patterns
  8. Output format
More from Awesome-Journal-Skills
All skills →
About this skill
What does the jep-writing-style skill do?

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.

How do I install it?

Run `npx skills add brycewang-stanford/Awesome-Journal-Skills --skill jep-writing-style --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.

Where does this skill come from?

From brycewang-stanford/Awesome-Journal-Skills, a repository with 909 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.

Is a popular skill a good skill?

Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.

Keep going