sci-figures
A Claude Code plugin for Nature-style research figures (main, Extended Data, supplementary) and their legends. The agent writes the plotting code (matplotlib, seaborn, scanpy, spatialdata-plot); the skill says what the result must achieve, from the figure's message to its export as one PDF with editable Arial text, and has independent reviewers check the layout and the legend against the code.
| Part | What it does |
|---|---|
skills/sci-figures/ |
The workflow, visual and legend conventions, the two reviews, setup, and two complete example figures (outline, script, legend). Loaded on demand. |
src/scifig/ |
apply_style, mm layout (new_figure, add_axes_mm, panel_letter), recurring elements (badge, colorbar, embedding_axes, scale_bar) and save, which checks fonts, sizes and raster resolution. |
Use
Ask Claude for a figure, a panel or a legend in the repo that holds the figure scripts.
- It agrees the format and an outline with you (message, story line, one entry per panel) and saves the outline next to the script.
- It computes the plotted data, then writes one script per figure that only loads and plots it.
- It checks the preview against the layout checklist, writes the legend from the code and the data, and runs the layout and legend reviews in parallel.
- It shows you the PDF with its legend and lists the review findings it declined.
Colors and marks shared across a paper's figures live in the repo's resources/figure_conventions.yaml.
Install
The plugin, once per machine, from the quadbio marketplace.
The package, Arial and TeX (for equations): skills/sci-figures/references/setup.md.
Develop
uv sync --group dev
uv run python -m scifig.fonts # Arial, once per machine
uv run pytest # the equation test is skipped without TeX
uv run pre-commit run --all-files
claude plugin validate .
claude --plugin-dir . # try the skill from this checkout
The example figures: uv run --extra examples python skills/sci-figures/examples/fig1_moscot.py writes
figures/fig1_moscot.pdf, its legend and preview (needs TeX). The spatial one needs the spatial-examples extra and the
Xenium dataset (fig2_spatial_outline.md, Source): run fig2_spatial_data.py (about 7 min on 8 cores), then
fig2_spatial.py.
For live package edits in a figure repo, depend on the checkout instead:
sci-figures = { path = "../sci-figures", editable = true }.
Release
Bump version in .claude-plugin/plugin.json and merge: the marketplace follows main, and users update when the
version changes. On that merge, release.yaml publishes the package to PyPI as sci-figures, then tags v<version> and
creates a GitHub Release.
License
MIT
1 maintainer
Metadata
1 maintainer
Release files for sci-figures 0.3.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| sci_figures-0.3.0.tar.gz | 305.4 kB | With provenance | Details for sci_figures-0.3.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| sci_figures-0.3.0-py3-none-any.whl | Python 3 | none | any | Details for sci_figures-0.3.0-py3-none-any.whl |
Total release size: 319.1 kB
Release files / sci_figures-0.3.0.tar.gz
| Download URL | sci_figures-0.3.0.tar.gz |
|---|---|
| Size | 305.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
a7d4c34711f015d87c3fd27980fab004e0729714691e9744c3add5f8eb2860ef
|
|
BLAKE2b-256 checksum How to use checksums |
313a1bc2850203d7b0d78c8bd7b045a44454a8220edbbdf04201d5eb61183242
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 28, 2026.
Transparency logRelease files / sci_figures-0.3.0-py3-none-any.whl
| Download URL | sci_figures-0.3.0-py3-none-any.whl |
|---|---|
| Size | 13.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
53e474a5ba9c15aff05cf2a8a5c748976dbc6de2c886146734271a12e3277371
|
|
BLAKE2b-256 checksum How to use checksums |
dffb2888d6176487e123ee43a919a67f4399843f3715e3974c266a3641acf59d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 28, 2026.
Transparency logSecurity for sci-figures 0.3.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
All 2 files in this release have been uploaded with provenance metadata.
Attestation for sci_figures-0.3.0.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 28, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
