Figures & Tables (jama-figures-tables)
When to trigger
- The RCT/review lacks its required flow diagram
- Tables are cluttered, over-numerous, or exceed the journal's exhibit allowance
- The baseline-characteristics table is missing or misused
- A figure shows p-values but not effect sizes / confidence intervals
The exhibits a JAMA paper usually needs
| Exhibit |
Purpose |
| Flow diagram (CONSORT/PRISMA/STARD) |
Participant or study-selection accounting |
| Table 1 — baseline characteristics |
Describe groups; show comparability (not significance) |
| Main-outcome table |
Primary/secondary effects with 95% CIs |
| Forest plot (meta-analysis / subgroups) |
Effect sizes + CIs across studies/subgroups |
| Kaplan-Meier / time-to-event figure |
Survival or event curves with numbers at risk |
Keep the count within JAMA's current figure/table limit — verify the exact number on the Instructions for Authors page rather than assuming.
Conventions JAMA expects
- Flow diagram is mandatory for RCTs (CONSORT) and systematic reviews (PRISMA). Account for every participant/record: screened, excluded (with reasons), enrolled, analyzed.
- Table 1 shows comparability, not p-values. For RCTs, comparing baseline groups with significance tests is discouraged; report characteristics and let randomization speak.
- Every estimate carries its 95% CI in figures and tables, not bare p-values.
- Self-contained exhibits. Each table/figure stands alone: full title, defined abbreviations in the footnote, units, denominators (n/N), and the analysis population.
- Kaplan-Meier curves include numbers at risk beneath the time axis.
- Forest plots order studies sensibly, show weights and the pooled estimate with its CI, and report heterogeneity.
- No chartjunk. Avoid 3-D bars, truncated axes that exaggerate effects, and dual axes that mislead.
- Color and accessibility. Use colorblind-safe palettes; ensure the figure reads in grayscale.
Checklist
Anti-patterns
- Submitting an RCT or review with no flow diagram
- P-value-laden Table 1 implying randomization "failed"
- Bars or curves with no confidence intervals
- Truncated y-axis that visually inflates a small effect
- KM plot without numbers at risk
- The same numbers shown in both a table and a figure
- Abbreviations undefined in the footnote
Worked example: auditing the main exhibits (illustrative)
Vignette (illustrative): a multicenter randomized clinical trial, N = 2,200 adults, time-to-event primary outcome. For the Journal of the American Medical Association, the exhibit set is a CONSORT flow diagram reconciling all 2,200 participants (screened, randomized, analyzed, lost), a Table 1 of baseline characteristics shown without between-group significance tests, a main-outcome table giving the hazard ratio with its 95% CI plus the absolute risk difference, and a Kaplan-Meier figure with numbers at risk beneath the time axis. A bar chart of the primary outcome with no confidence interval, or a truncated y-axis that visually inflates a small effect, is the kind of exhibit a JAMA reviewer sends back.
Reviewer pushback and the JAMA fix
- "RCT submitted with no flow diagram." Fix: add the CONSORT diagram and reconcile every participant with reasons for exclusion.
- "Table 1 reports p-values (RCT)." Fix: drop the significance tests; show characteristics and let randomization speak.
- "Figure shows p-values, not effect sizes." Fix: display the estimate with its 95% CI on every exhibit.
Calibration anchors (hedge where uncertain): the mandatory flow diagram, p-value-free Table 1 for RCTs, estimate-plus-CI on every exhibit, and numbers-at-risk on KM curves are durable; the exact figure/table allowance is volatile — confirm against current author guidelines.
Exhibit pass for JAMA
Run this as a concrete capability pass. First lock the clinical question, patient population, estimand or endpoint, safety/ethics issue, and reporting checklist; then test whether the manuscript addresses clinical reviewers who ask whether the evidence changes patient care, policy, or medical decision-making while satisfying reporting standards.
- Primary move: For every figure or table, state the patient/study object, denominator, uncertainty display, and the clinical claim it supports.
- Decision ledger: return
claim / evidence / blocker / next edit rows so the next pass can patch the manuscript directly.
- Sibling comparison: compare against NEJM for field-changing clinical medicine, Lancet for global-health breadth, specialty journals for narrower clinical domains; if the neighboring outlet has the stronger audience claim, recommend re-routing before polishing.
- Verification floor: before submission-ready advice, re-open
resources/official-source-map.md for volatile rules and name the one unresolved fact that could change the recommendation.
Output format
【Flow diagram】present + reconciles / missing
【Table 1 appropriate】yes / no
【All estimates show 95% CI】yes / no
【Exhibit count vs limit】X (limit per author instructions)
【Self-contained exhibits】yes / fixes: ...
【Issues to fix】...
【Next skill】jama-structured-abstract
Source: brycewang-stanford/Awesome-Journal-Skills → JAMA-Skills/skills/jama-figures-tables/SKILL.md
1---2name: jama-figures-tables3description: Use when designing or auditing the figures and tables of a JAMA manuscript, including the required flow diagram, baseline table, and main-result exhibits. Shapes exhibits for JAMA conventions; it does NOT run the statistics or write the abstract.4---567# Figures & Tables (jama-figures-tables)89## When to trigger1011- The RCT/review lacks its required flow diagram12- Tables are cluttered, over-numerous, or exceed the journal's exhibit allowance13- The baseline-characteristics table is missing or misused14- A figure shows p-values but not effect sizes / confidence intervals1516## The exhibits a JAMA paper usually needs1718| Exhibit | Purpose |19|-------------------------------------------|--------------------------------------------------------|20| Flow diagram (CONSORT/PRISMA/STARD) | Participant or study-selection accounting |21| Table 1 — baseline characteristics | Describe groups; show comparability (not significance) |22| Main-outcome table | Primary/secondary effects with 95% CIs |23| Forest plot (meta-analysis / subgroups) | Effect sizes + CIs across studies/subgroups |24| Kaplan-Meier / time-to-event figure | Survival or event curves with numbers at risk |2526Keep the count within JAMA's current figure/table limit — verify the exact number on the Instructions for Authors page rather than assuming.2728## Conventions JAMA expects2930- **Flow diagram is mandatory** for RCTs (CONSORT) and systematic reviews (PRISMA). Account for every participant/record: screened, excluded (with reasons), enrolled, analyzed.31- **Table 1 shows comparability, not p-values.** For RCTs, comparing baseline groups with significance tests is discouraged; report characteristics and let randomization speak.32- **Every estimate carries its 95% CI** in figures and tables, not bare p-values.33- **Self-contained exhibits.** Each table/figure stands alone: full title, defined abbreviations in the footnote, units, denominators (n/N), and the analysis population.34- **Kaplan-Meier curves include numbers at risk** beneath the time axis.35- **Forest plots** order studies sensibly, show weights and the pooled estimate with its CI, and report heterogeneity.36- **No chartjunk.** Avoid 3-D bars, truncated axes that exaggerate effects, and dual axes that mislead.37- **Color and accessibility.** Use colorblind-safe palettes; ensure the figure reads in grayscale.3839## Checklist4041- [ ] Required flow diagram present and reconciles all participants/records42- [ ] Table 1 reports characteristics without inappropriate significance testing (RCT)43- [ ] Every effect estimate shows its 95% CI44- [ ] Each exhibit is self-contained (title, footnotes, abbreviations, units, n/N)45- [ ] KM curves show numbers at risk; forest plots show weights + pooled CI + heterogeneity46- [ ] Total figures + tables within the journal's limit (verify current number)47- [ ] Axes honest (no truncation that exaggerates); palette colorblind-safe48- [ ] No duplication of the same data across a table and a figure4950## Anti-patterns5152- Submitting an RCT or review with no flow diagram53- P-value-laden Table 1 implying randomization "failed"54- Bars or curves with no confidence intervals55- Truncated y-axis that visually inflates a small effect56- KM plot without numbers at risk57- The same numbers shown in both a table and a figure58- Abbreviations undefined in the footnote596061## Worked example: auditing the main exhibits (illustrative)6263Vignette (illustrative): a multicenter randomized clinical trial, N = 2,200 adults, time-to-event primary outcome. For the Journal of the American Medical Association, the exhibit set is a CONSORT flow diagram reconciling all 2,200 participants (screened, randomized, analyzed, lost), a Table 1 of baseline characteristics shown without between-group significance tests, a main-outcome table giving the hazard ratio with its 95% CI plus the absolute risk difference, and a Kaplan-Meier figure with numbers at risk beneath the time axis. A bar chart of the primary outcome with no confidence interval, or a truncated y-axis that visually inflates a small effect, is the kind of exhibit a JAMA reviewer sends back.6465## Reviewer pushback and the JAMA fix6667- "RCT submitted with no flow diagram." Fix: add the CONSORT diagram and reconcile every participant with reasons for exclusion.68- "Table 1 reports p-values (RCT)." Fix: drop the significance tests; show characteristics and let randomization speak.69- "Figure shows p-values, not effect sizes." Fix: display the estimate with its 95% CI on every exhibit.7071Calibration anchors (hedge where uncertain): the mandatory flow diagram, p-value-free Table 1 for RCTs, estimate-plus-CI on every exhibit, and numbers-at-risk on KM curves are durable; the exact figure/table allowance is volatile — confirm against current author guidelines.7273## Exhibit pass for JAMA7475Run this as a concrete capability pass. First lock the clinical question, patient population, estimand or endpoint, safety/ethics issue, and reporting checklist; then test whether the manuscript addresses clinical reviewers who ask whether the evidence changes patient care, policy, or medical decision-making while satisfying reporting standards.7677- **Primary move:** For every figure or table, state the patient/study object, denominator, uncertainty display, and the clinical claim it supports.78- **Decision ledger:** return `claim / evidence / blocker / next edit` rows so the next pass can patch the manuscript directly.79- **Sibling comparison:** compare against NEJM for field-changing clinical medicine, Lancet for global-health breadth, specialty journals for narrower clinical domains; if the neighboring outlet has the stronger audience claim, recommend re-routing before polishing.80- **Verification floor:** before submission-ready advice, re-open `resources/official-source-map.md` for volatile rules and name the one unresolved fact that could change the recommendation.8182## Output format8384```85【Flow diagram】present + reconciles / missing86【Table 1 appropriate】yes / no87【All estimates show 95% CI】yes / no88【Exhibit count vs limit】X (limit per author instructions)89【Self-contained exhibits】yes / fixes: ...90【Issues to fix】...91【Next skill】jama-structured-abstract92```9394---9596**Source:** [`brycewang-stanford/Awesome-Journal-Skills`](https://github.com/brycewang-stanford/Awesome-Journal-Skills) → `JAMA-Skills/skills/jama-figures-tables/SKILL.md`