Agent Skills
› brycewang-stanford/Awesome-Journal-Skills
› jep-exhibits-for-general-readers
jep-exhibits-for-general-readers
GitHub专为JEP文章设计面向大众读者的图表，强调清晰与自解释。原则包括一图一点、标题陈述发现、用图表替代密集表格、去除显著性星号及系数堆砌、简化装饰，确保非专业人士能秒懂核心观点。
Trigger Scenarios
从研究论文移植的密集图表
读者需结合正文才能解读的图表
图表过多或未能推进论证
使用带系数和星号的回归表
Install
npx skills add brycewang-stanford/Awesome-Journal-Skills --skill jep-exhibits-for-general-readers -g -y
SKILL.md
Frontmatter
{
"name": "jep-exhibits-for-general-readers",
"description": "Use when designing figures and tables for a Journal of Economic Perspectives (JEP) article aimed at a broad audience — clarity over density, self-explanatory exhibits. Handles exhibit design; defer prose evidence to jep-evidence-without-equations and overall structure to jep-narrative-arc."
}
Exhibits for General Readers (jep-exhibits-for-general-readers)
When to trigger
- A figure or table was lifted straight from a research paper and is dense
- A reader needs the caption and the body text to decode an exhibit
- The piece has too many exhibits, or exhibits that don't advance the argument
- A regression table with coefficients and asterisks is doing the explaining
The JEP exhibit bar
A JEP exhibit must be self-explanatory to a non-specialist and earn its place in the argument. Clarity beats density: the reader should grasp the point from the exhibit and its caption alone, in seconds, without parsing the methods. JEP avoids significance asterisks and coefficient-table presentation in favor of exhibits that show the idea.
Design principles
- One exhibit, one point. Each figure/table makes a single claim that maps to a step in the narrative arc. If it makes three points, split it or cut two.
- Self-explanatory title + caption. The title states the finding ("Pass-through has fallen since 2000"), not the variables ("Price on cost, 1990–2020"). The caption gives source, units, and the one thing to notice.
- Figures over tables for trends and comparisons. A clear line/bar chart usually beats a number grid for a general reader. Reserve tables for a few labeled, rounded quantities.
- Round and label. Plain units, rounded numbers, direct labels on lines/bars instead of a legend the reader must cross-reference.
- No significance asterisks or coefficient dumps. If uncertainty matters, show it as a shaded band or a stated range, not stars (mirrors
jep-evidence-without-equations). - Minimal chartjunk. No 3-D, no needless gridlines, no decorative color. Color should encode meaning or be dropped (and survive grayscale, since print/archives may be monochrome).
- Few, load-bearing exhibits. A short synthesis essay carries a handful of exhibits, each indispensable — not a research paper's full battery.
Table discipline (when a table is right)
- Rows/columns labeled in plain words, not variable names.
- A small number of rounded figures, not full estimation output.
- A one-line note: source, units, sample/coverage, and the takeaway.
- No standard-error parentheses-and-stars apparatus; if precision matters, state a range in the note.
Checklist
- Each exhibit makes exactly one point tied to a narrative step
- Title states the finding; caption gives source, units, and what to notice
- Figures used for trends/comparisons; tables only for a few labeled quantities
- Numbers rounded; lines/bars directly labeled (legend minimized)
- No significance asterisks, no raw coefficient tables
- Uncertainty shown as band/range, not stars
- Exhibit is legible in grayscale; no chartjunk
- Total exhibit count is small and every one is load-bearing
Worked vignette (illustrative)
A draft transplants a research-paper Table 3: eight columns of coefficients, standard errors in parentheses, and rows of asterisks, titled "Regression results." The JEP exhibit replacing it is a single line chart titled with its finding — "Pass-through to consumer prices has roughly halved since 2000" — one line, directly labeled, a shaded band for the range across studies, source and units in a one-line note, and nothing else. The reader gets the point in three seconds, in grayscale, without reading the body — which is the entire test.
Anti-patterns
- A regression table with coefficients, SEs, and *** transplanted from the working paper
- A figure whose point you can't state in its title
- Legends and variable names that force the reader back into the text
- Color or 3-D that carries no information (and breaks in grayscale)
- Ten exhibits where three would carry the argument
- A "kitchen-sink" table of every specification (that belongs in research, not JEP)
Output format
【Exhibit】[figure/table] — one-point claim: [...]
【Finding-title】[...]
【Caption】source / units / what to notice
【Form】figure (trend/comparison) / small labeled table — chosen because [...]
【Uncertainty shown as】band / stated range (no asterisks)
【Grayscale-safe + chartjunk-free?】[Y/N]
【Count check】N exhibits, each load-bearing? [Y/N]
【Next step】jep-writing-style
Version History
- 1839142 Current 2026-07-05 13:35
