Agent Skills
› brycewang-stanford/Awesome-Journal-Skills
› apsr-tables-figures
apsr-tables-figures
GitHub专为APSR论文设计，指导制作自包含、无障碍且符合字数限制的表格与图表。涵盖触发场景、核心原则（如主文与附录区分）、学科特定展示形式及StatsPAI/Stata执行桥接，确保结果呈现清晰并有效利用字数预算。
Trigger Scenarios
设计主要结果表或关键描述性图表
决定内容放入正文还是在线附录
回复审稿人关于图表不清晰或非自包含的质疑
为压缩字数将图表移至附录
Install
npx skills add brycewang-stanford/Awesome-Journal-Skills --skill apsr-tables-figures -g -y
SKILL.md
Frontmatter
{
"name": "apsr-tables-figures",
"description": "Use when building tables and figures for an American Political Science Review (APSR) manuscript so exhibits are self-contained, accessible, and count toward the word budget correctly. APSR word counts include tables, figures, and printed footnotes, so exhibits must earn their space. Designs exhibits; it does not run the analysis."
}
Tables & Figures (apsr-tables-figures)
Exhibits are where an expert reviewer checks whether the result is real. At APSR they also cost words: the word count "includes tables, figures, and footnotes that appear in the published text" (it excludes the reference list and online appendices). So every exhibit must pull its weight.
When to trigger
- Designing the main results table/figure or a key descriptive exhibit
- Deciding what belongs in the article vs. the online appendix
- A reviewer found an exhibit unclear, mislabeled, or non-self-contained
- Trimming to the word cap by moving exhibits to the appendix
Principles
- Self-contained. A reader should understand each exhibit from its title, axis/column labels, and note alone — without hunting through the text. State units, sample, N, and what the estimate is.
- Figures over dense tables for effects. Coefficient/forest plots, marginal-effects and predicted-probability plots, event-study and RD plots communicate magnitude and uncertainty better than a wall of coefficients. Show intervals.
- Accessible. Colorblind-safe palettes; legible in grayscale; no chartjunk, no 3D, no needless color. Reviewers and readers must parse it quickly.
- Main text vs. appendix. Keep the few exhibits that carry the argument in the article; move balance tables, full specifications, and robustness grids to the online appendix (excluded from the word count). This is also how you fit under ~11,000 / ~7,000 words.
- Reproducible. Each exhibit is generated by the master script; numbers match the deposited
reproducibility package exactly (the editors re-run it — see
apsr-transparency-and-data-policy).
Discipline-specific exhibits
- Maps for geographic/spatial variation; network diagrams where structure is the point.
- Conjoint AMCE plots; survey-experiment treatment-effect plots.
- For qualitative work: timelines, causal-process diagrams, evidence tables linking claims to sources.
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. APSR is general-interest political science — observational causal designs (DiD/IV/RDD) and survey/field experiments alike; cluster by the right unit and foreground identification.
- 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)
- Reporting significance stars with no effect size or interval
- Cramming every robustness check into the main text (blows the word budget — use the appendix)
- Color-only encoding that fails in grayscale or for colorblind readers
- Exhibit numbers/values that don't match the deposited code output
Output format
【Main exhibit】what it shows + why a figure/table
【Self-contained?】title + labels + note + N/units present? [Y/N]
【Accessible?】grayscale-legible + colorblind-safe? [Y/N]
【Article vs appendix】split decided, word-budget impact noted
【Reproducible?】generated by master script, matches package? [Y/N]
【Next】apsr-writing-style
Supplementary resources
../../resources/external_tools.md— plotting/mapping/network packages../../resources/official-source-map.md— word-count rule (includes tables/figures/footnotes)
Version History
- 1839142 Current 2026-07-05 12:21
