Agent Skills
› brycewang-stanford/Awesome-Journal-Skills
› cps-tables-figures
cps-tables-figures
GitHub专为CPS论文设计表格与图表，确保其自包含且具可比性。指导构建核心发现图、精简结果表及描述性图表，强调标题、注释需清晰展示单位、样本与估计细节。遵循SAGE出版规范（如灰度可读、矢量输出），利用MCP工具生成数据以支持比较政治学的识别策略论证。
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
