Skip to content
Skills Library
Science & research · Building & coding

figures

/figures

Makes publication-quality plots from data with matplotlib, learning curves, scaling laws, benchmark and ablation comparisons, Pareto trade-offs, heatmaps and confusion matrices, sized for the page, vector, with uncertainty shown. Use whenever results are plotted, charted or visualized for a paper, report or answer, or an existing plot looks unpolished. Not for conceptual diagrams or schematics (use schematics) and never for drawing numbers that did not come from a run.

Repository
openscience ↗
Licence
Apache-2.0
Last repository change
25.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
7
Scripts
1
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 25.10.2026, without references to retired models or APIs.

Licence

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

What to check before installing
  • 1 scripts in this package. Review them before installing, as Claude may execute them.

Scripts: assets/figstyle.py

What it does and when to use it

Makes publication-quality plots from data with matplotlib, learning curves, scaling laws, benchmark and ablation comparisons, Pareto trade-offs, heatmaps and confusion matrices, sized for the page, vector, with uncertainty shown. Use whenever results are plotted, charted or visualized for a paper, report or answer, or an existing plot looks unpolished. Not for conceptual diagrams or schematics (use schematics) and never for drawing numbers that did not come from a run.

Original author description

Makes publication-quality plots from data with matplotlib, learning curves, scaling laws, benchmark and ablation comparisons, Pareto trade-offs, heatmaps and confusion matrices, sized for the page, vector, with uncertainty shown. Use whenever results are plotted, charted or visualized for a paper, report or answer, or an existing plot looks unpolished. Not for conceptual diagrams or schematics (use schematics) and never for drawing numbers that did not come from a run.

How it works

  1. Non-negotiables
  2. Set up once per project
  3. Where the figure goes
  4. Write the caption with the figure
  5. Multi-panel figures
  6. Read exactly one reference
  7. Before you hand it over
Original SKILL.md headings · 128 lines, 1,115 words
SKILL.md preview
---
name: figures
description: Makes publication-quality plots from data with matplotlib, learning curves, scaling laws, benchmark and ablation comparisons, Pareto trade-offs, heatmaps and confusion matrices, sized for the page, vector, with uncertainty shown. Use whenever results are plotted, charted or visualized for a paper, report or answer, or an existing plot looks unpolished. Not for conceptual diagrams or schematics (use schematics) and never for drawing numbers that did not come from a run.
summary: "Publication plots from real data: sized for the page, vector, uncertainty shown."
category: core
role: workflow
allowed-tools: [Read, Write, Edit, Bash, python, experiments]
license: MIT
version: 1.0.0
author: Synthetic Sciences
metadata:
  skill-author: Synthetic Sciences
  adapted-from: alphaXiv OpenResearch orx-figures (MIT)
---

# Figures

A figure in a paper is an argument, not a screenshot of an array. It makes one claim, and a
reader who skips the prose should still get that claim right. Default plotting output does
not clear that bar: it is sized for a screen, titled where a caption belongs, colored from
a cycle that collapses in greyscale, and rasterized where the document wants vector.

## Non-negotiables

1. **Build at the final printed size.** Pick the width from the document (`COLUMN` 3.25 in,
   `TEXT` 5.5 in, `WIDE` 6.75 in in the style module) and include it with
   `width=\linewidth`. Never build big and rescale: a 15-inch canvas dropped into a
   5.5-inch column turns 11 pt tick labels into 4 pt.
2. **Vector out.** PDF for `\includegraphics`, SVG beside it for preview. A rasterized plot
   blurs under the zoom every reviewer uses. PNG is only for genuinely raster content: a
   photograph, a sample grid, an attention map at pixel resolution.
3. **Every number comes from a run.** Read tracked metrics with the experiments tool
   (`experiments series`, `experiments compare`) or from the run's own output files. Never
   plot a remembered, rounded or plausible number, and never leave demo data in a script
   that ships.
4. **The caption is the title.** No axes title on a paper figure; panel letters (**a**,
   **b**) name the parts of a multi-panel figure.
5. **Show the uncertainty, or say there is none.** One seed is an anecdote. Plot the
   interval across seeds and state the seed count in the caption; with one run, write
   "single seed".
6. **Label axes with units.** "Loss" is a label; "step" without saying whether it counts
   optimizer steps or tokens is not.
7. **Colorblind-safe, greyscale-safe.** Use the module's Okabe-Ito palette. Never `jet`,
   `rainbow` or `hsv`; they invent structure the data does not have. Baselines and chance
   levels are grey: color belongs to the things being compared.
8. **One sans-serif face across every figure**, diagrams included. `use_style()` sets it.
   Pass `use_style(family="serif")` only for a figure carrying heavy math on a serif page.

## Set up once per project

Copy the style module beside the figure scripts so a figure stays reproducible after this
session ends. The module lives in this skill's directory at `assets/figstyle.py`; read it
and write it to `figs/figstyle.py` in the working folder (do not import it from the skill
path, which is not part of the project).

```python
from figstyle import COLUMN, PALETTE, figure, save, use_style

use_style()
fig, ax = figure(width=COLUMN)
ax.plot(x, y, color=PALETTE["blue"])
save(fig, "figs/loss_curve")  # writes .pdf and .svg, prints an audit line
```

Plots that only need matplotlib and numpy run in the session's Python; plots that import
project code run in the project environment. Keep the script beside its output
(`figs/loss_curve.py` next to `figs/loss_curve.pdf`); a figure whose script is gone cannot
be corrected when a reviewer asks for one more seed.

## Where the figure goes

Write the figure and its script into the working folder, under `figs/` beside the `.tex`
for a paper, or under the report's own folder otherwise. Never write a figure you intend to
show into a temporary directory; link the saved path in the answer.

```latex
\begin{figure}[t]          % figure* for a WIDE figure in a two-column paper
  \centering
  \includegraphics[width=\linewidth]{figs/loss_curve.pdf}
  \caption{\textbf{LPO reaches the reward plateau in a third of the compute.}
  Held-out reward against training compute for LPO and two baselines; mean of 5 seeds,
  bands are 95\% intervals. The dotted line is the pretrained model.}
  \label{fig:loss}
\end{figure}
```

## Write the caption with the figure

Captions in current papers run about 28 words, often three sentences: a short bold phrase
naming the claim, then the detail a reader needs to trust it.

- Lead with the finding, not the setup. "Training curves for LPO and baselines" names the
  axes, which the axes already do.
- The figure must stand alone; a reader who skipped the section should still get the claim.
- Put the method facts here: seed count, what the band or bar means, smoothing,
  normalization, which points were fitted and which excluded, whether a frontier line is
  measured or a guide.
- Say what is not shown when it matters: a single seed, a truncated axis, a run cut short.
- Do not restate axis labels in prose.

## Multi-panel figures

- Label every panel `(a)`, `(b)`, ... at the top-left with `panel_labels()`.
- Share the axis when panels share a quantity (`sharey=True`); two panels of one metric on
  silently different ranges is the multi-panel version of a truncated bar axis.
- One legend for the figure, not one per panel.
- Panels read in argument order, left to right, top to bottom.
- If the panels do not support one claim, they are separate figures.

Build them with `figure_grid(nrows, ncols, width=TEXT, sharey=True)`.

## Read exactly one reference

Pick by the question the figure answers, not by the shape in mind.

| The figure answers | Read |
| --- | --- |
| How does a metric move over training, and is the gap bigger than seed noise? | `references/curves.md` |
| How does performance change with scale, and what does the trend predict? | `references/scaling.md` |
| Which method wins across benchmarks, or which ablated component mattered? | `references/comparison.md` |
| What is traded off against what: reward vs KL, quality vs cost or latency? | `references/pareto.md` |
| What does this 2D grid, confusion matrix or sweep look like? | `references/matrix.md` |

For a method, architecture or pipeline diagram, load the schematics skill instead: those
are rendered with `generate_image`, never hand-drawn as TikZ or SVG. When a plot must meet a
named journal's requirements, or needs a colour, metadata or export audit before submission,
load scientific-visualization alongside this skill for its publisher profiles and audit CLIs.

## Before you hand it over

- Read the audit line `save()` prints. It checks the printed width, font embedding, stray
  axes titles, missing axis labels, text under 5 pt, overlapping text and text off the
  canvas. `clean` is the bar; anything else is a defect to fix, not a warning to note.
- If the audit reports no publication font on the machine, say so rather than installing
  fonts; that changes the environment and needs the user's say.
- A label placed at a reference line or data point is the usual overlap; move it or give
  it `backgroundcolor="white"`.
- Open the PDF and read it at printed size. A tick label unreadable on screen at 100% is
  unreadable on paper.
- Every axis labelled with units; no stray title; uncertainty shown with n stated; no legend
  entry for a series that was cut; the script reruns from scratch and reproduces the file.
Files in this package (7)
  • SKILL.md 8 KB
  • assets/figstyle.py 21 KB
  • references/comparison.md 10 KB
  • references/curves.md 6 KB
  • references/matrix.md 7 KB
  • references/pareto.md 6 KB
  • references/scaling.md 8 KB

Versions

RepositoryScoreLicence
This page · synthetic-sciences/openscience100Apache-2.0
cherifya/figures100MIT
NoviaIntSysGroup/visual-core95MIT

Database snapshot: 13.11.2026 · package version 7816d87a89e1 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 95matplotlib-optimization-visualization
    When the user wants to turn optimization experiment data into figures: convergence curves with bands over seeds, Gantt charts, route plots, Pareto front plots, and performance profiles, at publication quality with vector output and single-column sizing. Also use when the user…
  • 100paper-figure
    Generate publication-quality figures and tables from experiment results. Use when user says \\\"\u753b\u56fe\\\", \\\"\u4f5c\u56fe\\\", \\\"generate figures\\\", \\\"paper figures\\\", or needs plots for a paper.
  • 100paper-figure
    Generate publication-quality figures and tables from experiment results. Use when user says \"画图\", \"作图\", \"generate figures\", \"paper figures\", or needs plots for a paper.
  • 90academic-figure
    Create, revise, or audit academic data/result figures for CS/AI/ML papers. Data/result plots default to Python-generated editable SVG with CS/AI/ML-specific design rules for benchmarks, ablations, training dynamics, robustness, diagnostics, distributions, confusion matrices, and…
  • 100paper-figure
    Generate publication-quality figures and tables from experiment results. Use when user says \"画图\", \"作图\", \"generate figures\", \"paper figures\", or needs plots for a paper.
  • 96icarus-figures
    Use when making reproducible publication-grade data figures (matplotlib) or TikZ method/framework figures for a paper.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.