Agent Skills
› brycewang-stanford/Awesome-Journal-Skills
› popdevr-tables-figures
popdevr-tables-figures
GitHub用于为人口与发展评论期刊设计自包含、无障碍且清晰的表格与图表。涵盖人口金字塔等独特统计图形，强调携带发展观点、展示不确定性及可重复性，指导主文与支持信息的取舍。
Trigger Scenarios
设计主要结果表图或关键描述性图表
决定内容属于正文还是补充材料
审稿人指出图表不清晰或缺乏自包含性
精简超出论证需要的图表集
Install
npx skills add brycewang-stanford/Awesome-Journal-Skills --skill popdevr-tables-figures -g -y
SKILL.md
Frontmatter
{
"name": "popdevr-tables-figures",
"description": "Use when building tables and figures for a Population and Development Review (PDR, Wiley \/ Population Council) manuscript so exhibits are self-contained, accessible, and legible to a broad demography-and-development readership. Covers distinctive demographic graphics (population pyramids, age schedules, survival curves, projection fans) and cross-country comparative exhibits. Designs exhibits; it does not run the analysis."
}
Tables & Figures (popdevr-tables-figures)
Exhibits are where an expert reader checks whether the result is real — and, at PDR, where a broad readership grasps both the population pattern and its development meaning. A figure must carry the population-and-development point to an economist or environmental scholar, not only a demographer. Keep the set tight: every exhibit must earn its place and the prose should not need it explained.
When to trigger
- Designing the main results table/figure or a key descriptive exhibit
- Deciding what belongs in the article vs. the supporting information
- A reviewer found an exhibit unclear, mislabeled, or non-self-contained
- Trimming an exhibit set that has grown past what the argument needs
Principles
- Self-contained. A reader should understand each exhibit from its title, axis/column labels, and note alone. State the population, period, age range, source/vintage, units, and N or exposure.
- Carry the development point. Title and note should make the population-and-development meaning legible, not just the demographic quantity — a reader outside demography must see the takeaway.
- Use the right demographic graphic for the quantity. Don't default to a bar chart when the data call for an age schedule, a population pyramid, a survival curve, or a projection fan.
- Show uncertainty. Confidence bands on rates, life-expectancy contributions, hazard/survival curves, decomposition components, and projection scenarios — not bare lines or point estimates.
- Accessible. Colorblind-safe palettes; legible in grayscale; no chartjunk, no 3D. Reviewers and a broad readership must parse it quickly.
- Main text vs. supporting information. Keep the few exhibits that carry the argument in the article; move full life tables, sensitivity grids, and supplementary detail to the supporting information.
- Reproducible. Each exhibit is generated by the master script; numbers match the deposited
materials (see
popdevr-transparency-and-data).
Distinctive demographic and comparative exhibits
- Population pyramids for age-sex structure and its change over time (and across development levels).
- Age schedules of fertility (ASFR), mortality (mx/qx), and migration; tempo-adjusted curves.
- Survival and hazard curves (Kaplan-Meier, cumulative-incidence for competing risks).
- Decomposition bar/stacked plots showing component contributions that sum to the total.
- Projection fans / scenario plots tied to policy or development futures, with uncertainty.
- Cross-country scatter / small-multiples linking a population quantity to a development indicator — with comparability caveats in the note.
- Small-multiple maps for spatial demographic variation.
Execution bridge (StatsPAI / Stata MCP)
Generate exhibits from the fitted result, not by retyping numbers (the usual source of
body-vs-supplement drift). Full map: execution-with-mcp. PDR is population studies blending quantitative and policy work; apply the chain to its empirical-causal papers.
- Tables:
etable(multi-model columns) ordid_summary_to_latexstraight from theresult_id. - Figures:
plot_from_result/enhanced_event_study_plot/event_study_table— axis units and the SE/clustering note baked in. - Every note names the estimator + clustering and states the effect size in interpretable units.
See a full fitted-result → exhibit chain in the JF execution walkthrough.
Anti-patterns
- Tables that require the prose to be intelligible (not self-contained)
- A generic bar chart where an age schedule, pyramid, or projection fan would reveal the pattern
- Rates, e0 contributions, or projections plotted with no uncertainty
- A cross-country scatter read as a development effect with no comparability caveat
- Exhibit numbers/values that don't match the deposited code output
Exhibit pass for PDR
Run this as a concrete capability pass. First lock the population process, the development/policy linkage, the data and time scale, the selection/measurement issue, and the uncertainty; then test whether the manuscript addresses PDR's broad audience who inspect both the population evidence and its development meaning.
- Primary move: For every table or figure, state the object, sample/case base, uncertainty display, and one sentence the exhibit proves about population and development for this venue.
- Decision ledger: return
claim / evidence / blocker / next editrows so the next pass can patch the manuscript directly. - Sibling comparison: compare against Demography and Population Studies (methods-forward), Population Research and Policy Review (applied policy), and Studies in Family Planning (programs); if a neighbor has the stronger audience claim, recommend re-routing before polishing.
- Verification floor: before submission-ready advice, re-open
resources/official-source-map.mdfor volatile rules and name the one unresolved fact that could change the recommendation.
Output format
【Main exhibit】what it shows + which graphic + the population-and-development point
【Self-contained?】title + labels + note + population/period/source/N present? [Y/N]
【Uncertainty shown?】bands/intervals on rates/curves/components/projections? [Y/N]
【Accessible?】grayscale-legible + colorblind-safe? [Y/N]
【Article vs SI】split decided, set kept tight?
【Reproducible?】generated by master script, matches package? [Y/N]
【Next】popdevr-writing-style
Supplementary resources
../../resources/external_tools.md— plotting, life-table, projection, and mapping packages../../resources/official-source-map.md— exhibit and supporting-information expectations
Version History
- 1839142 Current 2026-07-05 14:12
