Agent Skills
› brycewang-stanford/Awesome-Journal-Skills
› jep-writing-style
jep-writing-style
GitHub用于润色《经济展望》(JEP) 风格的文章，聚焦于提升句子层面的语气、摘要和开篇。强调清晰、权威且易读，去除复杂符号与被动语态，确保非专业读者也能理解核心论点与价值。
Trigger Scenarios
需要修订 JEP 文章的句子语气或摘要时
摘要过于学术化缺乏吸引力时
行文被动、晦涩或包含不应有的数学符号时
Install
npx skills add brycewang-stanford/Awesome-Journal-Skills --skill jep-writing-style -g -y
SKILL.md
Frontmatter
{
"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
Version History
- 1839142 Current 2026-07-05 13:35
