Agent Skills
› brycewang-stanford/Awesome-Journal-Skills
› cps-tables-figures
cps-tables-figures
GitHub为CPS论文设计自包含、可比较且符合SAGE出版要求的图表。优化展示核心发现与稳健性，确保标题、注释清晰，强调效应量与不确定性，支持小多图和灰度可读性，避免冗余回归表。
Trigger Scenarios
构建或修改正文表格和图表
审稿人指出图表不可读或信息过载
决定图表放入正文还是附录
准备符合SAGE生产规范的图表
Install
npx skills add brycewang-stanford/Awesome-Journal-Skills --skill cps-tables-figures -g -y
SKILL.md
Frontmatter
{
"name": "cps-tables-figures",
"description": "Use when designing tables and figures for a Comparative Political Studies (CPS) manuscript so each exhibit is self-contained, comparative-legible, and SAGE-ready. Improves the exhibits; it does not run the analysis or set the data policy."
}
Tables & Figures (cps-tables-figures)
CPS exhibits must carry the comparative argument on their own. A reviewer should grasp the cross-case or over-time story from the figure and its caption without hunting through the text. Because references, tables, and figures do not count toward the CPS word limit, exhibits are where you spend space — but only if each one earns its place.
When to trigger
- Building or revising the main-text tables and figures
- A reviewer found exhibits unreadable, over-stuffed, or not self-contained
- Deciding which exhibits belong in the paper vs. the supplementary/online appendix
- Preparing figures for SAGE production (color, resolution, grayscale legibility)
Exhibit priorities (in order)
- One main figure that is the finding. For most CPS papers this is a coefficient/forest plot, an event-study plot around a reform, an RD plot, or a marginal-effects/predicted-probability plot — not a wall of regression coefficients.
- A clean main results table with the headline specification and the key robustness columns only; push the full grid to the appendix.
- A comparative descriptive exhibit showing the cross-case or over-time variation the design exploits (so the reader sees the leverage).
- A balance / first-stage / pre-trends exhibit appropriate to the design.
Make every exhibit self-contained
- Title + caption state what is shown, the unit, the sample, and the comparison — readable alone.
- Notes give: estimator, fixed effects, clustering level, N (units and observations), and what the error bars are (CI level). For comparative panels, state the countries and the period.
- Units and scales labelled in substantive terms (percentage points, predicted probability), not raw coefficients a reader must decode.
- Effect sizes visible. Show magnitudes and uncertainty, not just significance asterisks.
Comparative-specific exhibit craft
- When comparing countries/regions, order and group them so the pattern is visible (by region, regime type, or the key covariate) rather than alphabetically.
- Use small multiples to show the same relationship across cases rather than one overplotted panel.
- Maps only when geography is the point; otherwise a sorted dot plot communicates better.
SAGE production notes (verify current specs)
- Colorblind-safe palettes; figures must remain legible in grayscale for print.
- Vector output (PDF/EPS) where possible; supply high-resolution raster otherwise.
- Match exhibit numbering in the manuscript exactly to the deposited replication output.
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. CPS is comparative politics — cross-national and sub-national designs; emphasize identification and clustered / multiway inference.
- 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.
Checklist
- One main figure conveys the finding without the text
- Every exhibit's notes give estimator, FE, clustering, N, and CI level
- Effect sizes and uncertainty are visible, not just stars
- Cross-case exhibits are ordered/grouped to reveal the comparative pattern
- Color choices survive grayscale; figures are vector or high-res
- Heavy tables moved to the appendix; each is referenced in the text
- Exhibit numbers match the replication output exactly
Anti-patterns
- A 40-coefficient table where one forest plot would carry the result
- Captions that require the text to interpret; missing N, clustering, or CI level
- Countries ordered alphabetically so the comparative pattern is invisible
- Significance-star tables with no effect magnitudes
- Figures that collapse to mush in grayscale; low-resolution raster images
Output format
【Main figure】what it shows + why it is the finding
【Main table】headline spec + which robustness columns; rest → appendix
【Comparative descriptive】the exhibit showing cross-case/over-time leverage
【Self-contained?】captions/notes give estimator, FE, clustering, N, CI [Y/N]
【Production】grayscale-safe + vector/high-res [Y/N]
【Next】cps-writing-style
Supplementary resources
../../resources/code/— table/figure generation scripts to adapt../../resources/external_tools.md— coefplot / ggplot / marginaleffects and mapping packages
Version History
- 1839142 Current 2026-07-05 12:38
