Skip to content
cccskills
FreePublished on GitHub

figure-captions

Writing figure captions that make figures self-contained — what to include, ordering, and statistical reporting.

The English summary is being prepared. Showing the original description.

See how to install

Files included (1)

  • SKILL.md6.3 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Overview

A figure plus its caption should be understandable without reading the paper — many readers see only these. This skill covers the caption's job (identify, describe, explain, interpret-with-restraint), the standard information each caption type needs (n, statistics, symbols, scale), and the editing that keeps captions complete but tight.

When to use

  • Writing captions for a paper, thesis, poster, or presentation
  • Making figures self-contained for skimmers and figure-browsers
  • Reporting statistics, sample sizes, and methods in captions correctly
  • Standardizing caption style across a multi-author paper
  • Fixing captions that merely restate the title or describe the obvious

Core concepts

  • The self-containment test: cover the figure, read only the caption — can you state what was measured, how, in what, and what the result was? If not, the caption fails.

  • Caption anatomy: (1) title phrase — what the figure shows; (2) method summary — what was done to produce it; (3) symbol/key definitions — every color, symbol, line, and abbreviation; (4) statistics — n, tests, p-values, intervals; (5) takeaway — one sentence on what it means (not a discussion, a pointer).

  • Define everything: every abbreviation, symbol, color, error-bar type, and line style appearing in the figure — the caption is the legend's backup and often its replacement.

  • Statistics belong in captions: sample sizes per group, the test used, exact p-values (not just stars — though stars are fine with a defined key), what error bars show (SD? SE? 95% CI? — always state).

  • Brevity with completeness: captions are not methods sections — summarize the method in a clause, cite the full protocol; but never omit what a reader needs to interpret the panel.

  • Panel referencing: multi-panel figures need (a), (b), (c) labels in both figure and caption, described in order — don't make readers hunt.

  • Caption length calibration: one sentence for simple schematics, a full paragraph for multi-panel data figures — length should match information density, not author laziness or verbosity.

  • Statistical reporting standards: exact p-values, effect sizes with intervals, test names, n per group, multiple-comparison corrections — the caption is where methods meet results; skimping here is the most common caption failure.

  • Accessibility: captions are read by screen readers — write them as coherent prose describing the figure's content and message, not as telegraphic fragments.

Practical workflow

1. Draft per panel, then assemble

  1. For each panel write: what is plotted (axes, units), the experimental condition, the key observation with numbers.
  2. Assemble in panel order with (a), (b), (c) markers; check the caption's order matches the figure's layout.
  3. Add the shared information once (sample sizes, statistics, abbreviations) rather than repeating per panel.

2. Include the non-negotiables

  • n: per group/condition, and what n counts (animals? cells? technical replicates?) — "n = 6" is ambiguous; "n = 6 mice per group" is not.
  • Statistics: test name, exact p or the star key, correction for multiple comparisons, what the bars/bands show.
  • Scale: scale bars on images (with length), axis units everywhere, colorbar units on heatmaps.
  • Replicates: how many independent experiments; whether points are biological or technical replicates.

3. Write the takeaway sentence

  1. End with one interpretive sentence: what does this figure establish? ("Together, these data indicate X mediates Y.")
  2. Keep it to what the figure shows — save the broader interpretation for the Discussion.
  3. Make sure the takeaway matches the Results text — caption and body must agree.

4. Edit for consistency

  1. Standardize across all figures: "mean ± SD" vs "mean ± SEM" (pick one, define everywhere), p-value formatting, abbreviation style.
  2. Cut redundancy with the main text — the caption summarizes, the text elaborates; they shouldn't be identical paragraphs.
  3. Length check: if a caption exceeds ~200 words, consider moving method detail to Methods and keeping only the interpretive essentials.

5. Write captions for special figure types

  1. Micrographs/images: scale bar (with length), imaging modality and settings, what the arrows/arrowheads mark, sample identity and n.
  2. Schematics/models: define every symbol, arrow type, and color; state what the diagram asserts vs illustrates.
  3. Multi-panel composites: describe panels in order with (a), (b), (c) labels matching the figure; give the shared methods once, panel-specific details per panel.

6. Quick-reference checklist

  • Caption states what is shown AND what it means
  • Panels described in order with matching (a), (b), (c) labels
  • Sample sizes, statistics, error-bar definitions included
  • Scale bars, arrows, colors, and symbols defined
  • Every abbreviation defined at first use in the caption
  • Consistent terminology with the main text
  • Caption matches the final figure version (panel letters, counts)
  • Length calibrated to the figure's information density

Common pitfalls

  • Title-only captions: "Effect of X on Y." — describes nothing; the reader learns zero.
  • Undefined symbols: colors, stars, dashed vs solid lines unexplained — the most common caption failure.
  • Mystery error bars: bars without "SD/SE/CI" labels are uninterpretable — always state.
  • Ambiguous n: biological vs technical replicates unstated — inflates apparent rigor or hides pseudoreplication.
  • Caption–figure mismatch: describing panels that don't exist, wrong panel letters, statistics for a different analysis — update captions last, after figures are final.
  • Interpretation overreach: using the caption to make claims the figure doesn't support — the takeaway sentence must be earned by the panel.
  • Undefined abbreviations: every abbreviation in the figure or caption defined at first use in the caption — captions must stand alone.
  • Caption–figure drift: captions written for an earlier figure version (wrong panel letters, deleted panels described) — update captions last, after figures are final.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Master 1Password: vaults, Watchtower, passkeys, SSH agent, CLI, and family/team administration. Use when getting full value from 1Password personally or administering it for others.

The English summary is being prepared. Showing the original description.

aicodedecode/awesome-muse-skills28Updated Oct 10, 2026

Create 3D visuals with modeling, texturing, lighting, rendering, and optimization for web and product.

The English summary is being prepared. Showing the original description.

aicodedecode/awesome-muse-skills28Updated Oct 10, 2026

Create 3D web experiences: scene setup, models, materials, lighting, animation, scroll-driven scenes, and performance budgets. Use when adding 3D to websites beyond basic demos.

The English summary is being prepared. Showing the original description.

aicodedecode/awesome-muse-skills28Updated Oct 10, 2026

Writing abstracts that get papers read — structured content, the 5-sentence core, and journal-specific constraints.

The English summary is being prepared. Showing the original description.

aicodedecode/awesome-muse-skills28Updated Oct 10, 2026

Learn effectively from courses and academies: choosing programs, studying actively, and converting courses into skills. Use when investing time/money in structured learning.

The English summary is being prepared. Showing the original description.

aicodedecode/awesome-muse-skills28Updated Oct 10, 2026

Audit designs for accessibility with WCAG checklists covering color, type, focus, motion, and content.

The English summary is being prepared. Showing the original description.

aicodedecode/awesome-muse-skills28Updated Oct 10, 2026

See all skills by aicodedecode

Report a problem with this skill