io-tables-figures
GitHub用于国际组织稿件的图表设计，确保自包含、可复现并符合字数限制。指导如何根据论点权重选择正文或补充材料，强调明确分析单位、使用效应图而非系数表、色盲友好配色，以及确保图表与代码结果一致以通过验证。
Trigger Scenarios
Install
npx skills add brycewang-stanford/Awesome-Journal-Skills --skill io-tables-figures -g -y
SKILL.md
Frontmatter
{
"name": "io-tables-figures",
"description": "Use when building tables and figures for an International Organization (IO) manuscript so exhibits are self-contained, accessible, reproducible, and count toward the word budget correctly. IO word limits include tables, figures, and notes (but exclude the bibliography), and exhibits must survive IO's pre-publication result verification. Designs exhibits; it does not run the analysis."
}
Tables & Figures (io-tables-figures)
Exhibits are where an expert IR reviewer checks whether the result is real — and where IO's editorial staff will later confirm the numbers reproduce. At IO they also cost words: the word limit includes tables, figures, and notes (it excludes the bibliography). So every exhibit must pull its weight, and every value must match the deposited code.
When to trigger
- Designing the main results table/figure or a key descriptive/measurement exhibit
- Deciding what belongs in the article vs. the supplementary material (which should rarely exceed ~20 pp)
- A reviewer found an exhibit unclear, mislabeled, or non-self-contained
- Trimming to the word cap by moving exhibits to supplementary material
Principles
- State the level explicitly. IR exhibits are misread when the unit is implicit. Put the unit of analysis (state-year, directed-dyad-year, IGO, crisis) in the title or note, with the sample, N, time span, and what the quantity is. A dyadic coefficient and a monadic one look identical on a plot but mean different things.
- Plot effects; tabulate sparingly. For the headline international effect, a coefficient/forest plot, a marginal-effects or predicted-probability plot, or an event-study/RD plot conveys magnitude and uncertainty better than columns of coefficients. Always show the interval.
- Survive print and color limits. Use colorblind-safe palettes that stay legible in grayscale; drop 3D, chartjunk, and decorative color. A referee skimming the PDF must read it in seconds.
- Decide article vs. supplementary by argument weight. Keep only the exhibits that carry the IR claim in the article; relegate balance tables, full specifications, robustness grids, and proof-supporting tables to supplementary material (which should rarely exceed twenty pages, especially at first submission). Because the word count counts exhibits, this is also how you land under 14,000 / 8,000 / 10,000 words.
- Tie every number to the driver script. Each exhibit is regenerated by the analysis pipeline and
matches the deposited package — IO staff re-run it before final acceptance (see
io-transparency-and-data-policy).
IR-specific exhibits
- Maps for geographic/spatial variation (conflict locations, alliance/trade ties); network diagrams for alliance, trade, or IGO-membership structure where structure is the point.
- Dyad-level coefficient plots; conjoint AMCE plots and foreign-policy survey-experiment effect plots.
- For qualitative IR work: timelines of crises/negotiations, causal-process diagrams, evidence tables linking claims to archival/interview sources.
Exhibit-placement decision table (article vs. SI, word-aware)
Because IO counts exhibits toward the cap and the SI carries a ~20-page norm, every exhibit needs a placement verdict tied to argument weight:
| Exhibit | Carries the IR claim? | Placement |
|---|---|---|
| Headline international effect (forest / marginal-effects plot) | yes | main text — one figure, with interval |
| Balance/overlap, full specs, proof-supporting tables | no | supplementary |
| Descriptive map / network of ties | only if structure is the point | main text if structure is the argument |
Rule of thumb: if removing an exhibit would not weaken the core IR claim, it belongs in the SI.
Worked exhibit vignette (illustrative)
A treaty-compliance paper drafts five tables, with the headline result in a dense six-column dyad-level table. The IO redesign converts it to one coefficient plot with 95% intervals, titled "Effect of delegated monitoring on subsequent compliance, directed-dyad-year, 1990–2015, N≈42,000" (numbers illustrative) so the unit, sample, span, and quantity are self-contained — a referee reads magnitude and uncertainty in seconds. The four remaining tables move to supplementary material, keeping the main text under cap. Every plotted value is regenerated by the master script to match the package IO staff will re-run.
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. International Organization is IR — country/dyad panels with difficult identification; foreground the source of variation and robustness to alternative explanations.
- 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
- Leaving the unit/level implicit so a dyadic estimate reads like a monadic one
- An exhibit only intelligible after reading the prose around it
- Significance stars with no effect size or interval
- Pushing every robustness grid into the main text (it costs words; the SI also has a ~20-page norm)
- Color-only encoding that collapses in grayscale or for colorblind readers
- Printed values that diverge from the deposited code output (the IO re-run will flag it)
- A six-column dyadic table where one interval plot would convey the magnitude and save words
Output format
【Main exhibit】what it shows + why a figure/table
【Self-contained?】title + labels + note + N/units/level/time present? [Y/N]
【Accessible?】grayscale-legible + colorblind-safe? [Y/N]
【Article vs supplementary】split decided, word-budget + ~20-page SI noted
【Reproducible?】generated by master script, matches package for IO verification? [Y/N]
【Next】io-writing-style
Supplementary resources
../../resources/external_tools.md— plotting/mapping/network packages for IR data../../resources/official-source-map.md— word-count inclusion rule and supplementary-material guidance
Version History
- 1839142 Current 2026-07-05 13:23
