figure-spec

Generate deterministic editable SVG diagrams from structured JSON input.

Updated Jul 6, 2026
One-click install
npx skills add https://github.com/caw111/2026-SoftwareCup --skill figure-spec-caw111
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: figure-spec
Source: https://github.com/caw111/2026-SoftwareCup/tree/main/.agents/skills/figure-spec
Command: npx skills add https://github.com/caw111/2026-SoftwareCup --skill figure-spec-caw111

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill allows for the generation of deterministic publication-quality diagrams (architecture, workflow, pipeline) from structured JSON.

Core Features & Use Cases

  • Deterministic Diagrams: Generates consistent diagrams from the same JSON input.
  • Editable SVG Output: Creates SVG files for editable diagrams.
  • Structured JSON Input: Accepts JSON data for defining diagram components.
  • Use Case: Use the figure-spec skill to generate an architecture diagram for a system using JSON input.

Quick Start

Use the figure-spec skill to generate a diagram for a given JSON file.

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 input?

To generate deterministic SVG diagrams from JSON input, define your system architecture or workflow components in a structured JSON file. The skill processes this data to produce consistent, editable SVG figures for exact reproduction.

What is the best way to create reproducible system architecture diagrams?

The best way to create reproducible system architecture diagrams is using structured JSON input to define components. This approach generates deterministic, editable SVG files, ensuring exact reproduction across different runs.

Do I need Python to generate editable SVG figures from JSON?

Yes, you need Python installed to generate editable SVG figures from JSON. The skill relies on Python along with the pysvg and jsonschema dependencies to process structured data and render diagrams.

Can I use JSON to define workflow pipelines and output SVG files?

Yes, you can use JSON to define workflow pipelines and output SVG files. The skill accepts structured JSON data representing your pipeline components and generates deterministic, editable SVG diagrams.

Why use JSON-driven generation instead of manual diagram editors for publication-quality figures?

JSON-driven generation ensures deterministic, publication-quality figures that require exact reproduction. Unlike manual editors, structured JSON input provides consistency across system architecture and workflow diagrams, eliminating visual drift.

What are the limitations of generating SVG diagrams from JSON data?

A limitation of generating SVG diagrams from JSON data is the strict dependency on structured input formats. Diagrams require valid JSON definitions conforming to jsonschema, meaning unstructured or freeform layouts are not supported.