spec-render

Extract PlantUML diagrams from specification markdown and render them as SVG assets.

5|Updated Apr 29, 2026
One-click install
npx skills add https://github.com/friedbotstudio/baseline --skill spec-render
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-render
Source: https://github.com/friedbotstudio/baseline/tree/main/.claude/skills/spec-render
Command: npx skills add https://github.com/friedbotstudio/baseline --skill spec-render

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It turns raw PlantUML blocks inside spec documents into visual artifacts so reviewers can inspect diagrams instead of parsing dense markup.

Core Features & Use Cases

  • Extracts every PlantUML fence from docs/specs/<slug>.md in source order.
  • Classifies each diagram, writes numbered source files and SVG renders, and assembles an index page for fast review.
  • Use it when a specification needs a visual pass before approval, especially for architecture, sequence, state, and class diagrams.

Quick Start

Ask the skill to render the PlantUML diagrams for a specific spec slug so you can review the generated SVGs in the rendered output folder.

Frequently Asked Questions about spec-render

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

FAQPage Schema
How do I render PlantUML diagrams from markdown spec files into SVG?

Rendering PlantUML diagrams from markdown spec files into SVG involves extracting every PlantUML fence from docs/specs/<slug>.md in source order, classifying each diagram, and generating SVG assets. It assembles an index page so reviewers can inspect diagrams visually instead of parsing dense markup.

What is the best way to visually review PlantUML architecture diagrams before spec approval?

Visually reviewing PlantUML architecture diagrams before spec approval is best done by generating numbered SVG renders and an index.md page. This provides a fast visual pass for architecture, sequence, state, and class diagrams directly from the specification markdown.

Can I extract specific diagram types like sequence and state diagrams from a spec markdown file?

Extracting specific diagram types like sequence and state diagrams from a spec markdown file is supported. The process classifies each PlantUML diagram by kind, writing numbered source files and SVG renders for architecture, sequence, state, and class diagrams during the extraction workflow.

How do I start generating SVG previews from PlantUML blocks in my documentation?

Generating SVG previews from PlantUML blocks in documentation starts by asking the skill to render diagrams for a specific spec slug. It extracts the fences, generates the SVGs, and assembles an index page in the rendered output folder for immediate review.

What happens if a PlantUML diagram cannot render during spec review?

When a PlantUML diagram cannot render during spec review, the workflow provides explicit failure reporting. This ensures any problematic diagram blocks are identified immediately, preventing broken visual artifacts from passing the pre-approval checks.