figure-gate

figure-gate reads a matplotlib figure you have already built and tells you which publication requirements it fails. It checks colorblind-safe color, composition, and whether your type is still legible at the size the figure actually prints.

audit(fig) returns (ok, rows), 21 rows, one per check. Each row is a (name, status, detail) triple:

ok, rows = audit(fig)     # (False, [("Clipping", False, "clipped: [...]"), ...])

figure-gate verifies figures. It does not draw them, restyle them, or judge whether a figure is good. Each check forbids one named defect, so a figure that passes every row has avoided 21 named defects and nothing more.

Every threshold is a module-level constant you can read and change.

Try it

git clone https://github.com/narenp12/figure-gate && cd figure-gate
python skill/scripts/check_palette.py "#E69F00,#56B4E9,#009E73" --pairs all
python skill/scripts/check_figure.py     # self-test on a deliberately broken figure

The second command prints a failing report and exits 0, because a checker that cannot fail is not a checker.

python examples/demo.py builds that figure and audits it, and python examples/gallery.py covers the harder forms. Writing those eleven found seven defects in the checks themselves.

Documentation

The documentation site is organised by what you came to do.

Learning. Start here if you have not run the checkers before:

Doing a task. Step-by-step directions for a goal you already have:

Looking something up. What each check measures and what each function takes:

Understanding why. Background, evidence, and the decisions behind the thresholds:

Use it with Claude Code

This repository is also a plugin marketplace, so Claude Code applies the same checks when it builds a figure for you:

/plugin marketplace add narenp12/figure-gate

Then run /plugin install figure-gate@figure-gate. The skill is invoked as figure-gate:research-figures.

Where this sits

Prescriptive style sheets already exist and are good: SciencePlots and LovelyPlots for journal looks, tueplots and mpl_sizes for exact conference sizing. Accessibility tooling exists too: matplotalt generates alt text, Chart4Blind converts a chart image into an accessible one, and contrast reporters check colors in isolation.

Each of those acts before or beside the figure. None of them reads the built result and reports what it fails, which is the only thing figure-gate does. A style sheet and figure-gate are complementary: set your defaults with one, verify them with the other.

Stability

The public API is every name without a leading underscore in check_figure.py, check_palette.py, and suggest_fixes.py. Below version 1.0, a minor release may break it. Every break is named in the changelog under its release heading, and CI fails a pull request whose ## Unreleased section does not name a symbol that moved.

The number of rows is not part of the contract. The shape is. For the full statement, see how the checkers decide.

Contributing

New gates are welcome at the bar the project holds itself to:

• A test proving the gate fails on a figure with that defect.
• A test proving it does not over-fire on the nearest legitimate case.
• A note naming the real failure that motivated it.

See CONTRIBUTING.md and SECURITY.md.

License

MIT. See LICENSE.