figure-spec

Convert FigureSpec structured JSON into editable SVG diagrams.

Updated May 20, 2026
One-click install
npx skills add https://github.com/lightrain-a/medtrace-aris --skill figure-spec-lightrain-a
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: figure-spec
Source: https://github.com/lightrain-a/medtrace-aris/tree/main/.vendor/aris/skills/figure-spec
Command: npx skills add https://github.com/lightrain-a/medtrace-aris --skill figure-spec-lightrain-a

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Produce formal architecture, workflow, and pipeline figures that are deterministic and publication-ready, without relying on non-editable illustrations or manual diagram tweaking.

Core Features & Use Cases

  • Deterministic JSON → SVG rendering: the same FigureSpec JSON yields the same editable SVG output for consistent paper figures.
  • Publication-quality vector diagrams: create architecture, workflow pipelines, audit cascades, and system topology with clean typography and layouts.
  • Schema validation and guardrails: validated renderer behavior helps catch malformed specs early with clear error messages.
  • CJK-friendly labels: multi-line Chinese labels render with proper width estimation for readability.

Quick Start

Use the command python3 tools/figure_renderer.py render /path/to/spec.json --output figures/diagram.svg to turn your FigureSpec JSON into an editable SVG you can directly include in documentation.

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 architecture diagrams from JSON?

Generating deterministic SVG architecture diagrams from JSON requires converting structured FigureSpec JSON into editable SVG using a local figure renderer tool, ensuring identical JSON inputs yield consistent publication-quality vector output for reports.

What is the best way to create publication-quality workflow pipeline diagrams without manual tweaking?

Creating publication-quality workflow pipeline diagrams without manual tweaking involves defining node positions, labeled relationships, and grouping regions in FigureSpec JSON, then rendering deterministic editable SVG output for formal papers.

How do I render SVG diagrams with multi-line CJK labels?

Rendering SVG diagrams with multi-line CJK labels requires a figure renderer tool that supports proper width estimation for Chinese characters, ensuring readable multiline labels within structured FigureSpec JSON to editable SVG conversion.

Does FigureSpec JSON validation catch malformed diagram schemas before rendering?

FigureSpec JSON validation catches malformed diagram schemas before rendering by applying schema validation and guardrails, providing clear error messages early when shapes, edges, or groups fail to meet the required structure for deterministic SVG output.

Can I use deterministic SVG rendering for formal report figures?

Deterministic SVG rendering is ideal for formal report figures because it produces consistent, editable vector diagrams with clean typography and precise layouts, directly usable in documentation without relying on non-editable manual illustrations.

Why does my JSON to SVG diagram output look inconsistent across renders?

Inconsistent JSON to SVG diagram output occurs when the rendering process lacks deterministic rules; using a validated FigureSpec renderer ensures the same structured JSON input yields identical editable SVG output every time for reliable publication figures.