figure-spec

Generate deterministic SVG diagrams from structured FigureSpec JSON specifications.

38|3|Updated May 7, 2026
One-click install
npx skills add https://github.com/Chanw-research/claude-code-paper-writing --skill figure-spec-chanw-research
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: figure-spec
Source: https://github.com/Chanw-research/claude-code-paper-writing/tree/main/skills/figures/figure-spec
Command: npx skills add https://github.com/Chanw-research/claude-code-paper-writing --skill figure-spec-chanw-research

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Create publication-quality diagrams from structured JSON specifications that are guaranteed deterministic, editable, and reusable, reducing manual drawing work and drift.

Core Features & Use Cases

  • Deterministic: identical SVG output for a given FigureSpec JSON and renderer version.
  • Editable: SVG is plain text and can be tweaked by hand or programmatically.
  • No external API: runs fully locally without network access or keys.
  • Versatile diagrams: supports architecture, workflow, and system topology figures with proper grouping.
  • Validation: enforces a FigureSpec schema and reports meaningful errors.

Use cases include architectural diagrams for papers, data pipeline visuals for presentations, and topology maps for system documentation.

Quick Start

Provide a FigureSpec JSON file and run the renderer to produce an editable SVG diagram.

Frequently Asked Questions about figure-spec

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate deterministic SVG diagrams from JSON for publication?

You can generate deterministic SVG diagrams by providing a structured JSON specification, which is validated against a schema to ensure identical, editable vector output for publication-ready figures.

What is the best way to create reproducible architecture diagrams without manual drawing?

Creating reproducible architecture diagrams is best handled by defining system topology in a structured JSON specification, which renders into a deterministic and editable SVG without manual drawing.

Does this SVG diagram generation tool require network access or API keys?

No, this SVG diagram generation tool runs fully locally without network access or external API keys, ensuring data privacy and offline reproducibility.

Can I use the generated SVG output in LaTeX publishing workflows?

Yes, the generated SVG output is scalable vector graphics suitable for LaTeX and other publishing workflows, and it can be edited programmatically or by hand.

How do I validate a JSON specification before rendering an SVG diagram?

You validate a JSON specification by running it through the renderer, which enforces a strict schema and reports meaningful errors before producing the SVG diagram output.

Why does my SVG diagram output drift when re-rendering structured JSON?

SVG diagram output does not drift because the renderer is deterministic, guaranteeing identical SVG output for a given JSON specification and renderer version across multiple runs.