figure-spec

Convert structured JSON FigureSpec into deterministic SVG diagrams.

Updated Jun 7, 2026
One-click install
npx skills add https://github.com/czh-ee-2023/zotero-aris --skill figure-spec-czh-ee-2023
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: figure-spec
Source: https://github.com/czh-ee-2023/zotero-aris/tree/main/.claude/skills/figure-spec
Command: npx skills add https://github.com/czh-ee-2023/zotero-aris --skill figure-spec-czh-ee-2023

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python, and includes scripts (resource) components.

What problem does it solve?

This Skill addresses the need for generating high-quality, deterministic SVG diagrams from structured JSON input, providing a reliable way to create publication-ready architecture, workflow, and pipeline diagrams.

Core Features & Use Cases

  • Deterministic SVG Generation: Converts JSON FigureSpec into identical SVG output for consistent diagram creation.
  • Editable SVG: Outputs SVG files that are plain text and can be edited for precision and publication readiness.
  • Use Case: Ideal for technical writers and researchers who need to create detailed diagrams for academic papers, system architecture visualizations, or complex workflow illustrations.

Quick Start

Generate a diagram using the figure-spec skill with the following command: /figure-spec "Create a layered architecture diagram for the cloud computing stack."

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 technical documentation?

To generate deterministic SVG diagrams from JSON, you can use a Python-based rendering script to convert structured JSON FigureSpec into consistent SVG output. This ensures identical visual results for architecture and workflow diagrams across multiple builds.

Can I create publication-ready workflow diagrams using JSON input?

Yes, you can create publication-ready workflow diagrams using JSON input. The process converts structured data into plain text SVG files, which you can edit directly for precision and publication readiness in academic papers or system architecture visualizations.

Does Python need to be installed to render SVG diagrams from JSON?

Yes, Python is required to render SVG diagrams from JSON FigureSpec. The rendering and validation scripts rely on Python to process the structured input and generate the final deterministic SVG output for your technical documentation.

What is the best way to structure complex node connections and groupings for SVG output?

The best way to structure complex node connections and groupings for SVG output is to define them within a structured JSON FigureSpec. This format explicitly handles node positioning and relationships before Python rendering converts them into a deterministic SVG diagram.

Why use JSON for SVG diagram generation instead of manual vector editing?

Using JSON for SVG diagram generation ensures deterministic and consistent output, unlike manual editing. It allows you to programmatically define complex architecture and pipeline diagrams in structured text, guaranteeing identical SVG results for technical documentation.

Can I edit the SVG output after generating it from FigureSpec?

Yes, you can edit the SVG output after generating it from FigureSpec. The tool outputs plain text SVG files that are fully editable, allowing you to manually adjust precision and formatting for publication-ready technical documentation.