Skip to main content
skill CX Codex

plantuml — Claude Code skill: what it does, how to install

Builds specialized PlantUML diagrams and renders them to PNG or SVG. Useful when Markdown viewers lack native PlantUML rendering.

no license 3 installs ★ 61 updated 2026-08-24

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add SpillwaveSolutions/plantuml --skill plantuml -a claude-code
Open on GitHub

What plantuml does

This skill tackles diagram formats that Mermaid handles poorly or omits entirely. It focuses on Salt wireframes, use case flows, timing charts, ArchiMate views, nwdiag network topologies, and WBS breakdowns. The assistant can draft diagrams from scratch, parse existing .puml files, or pull embedded diagram blocks out of Markdown documentation.

Rendering relies on an external runtime. Without Java 8+ and a local plantuml.jar pointed to by PLANTUML_JAR or located in your home folder, image generation fails immediately. The repository includes scripts/check_setup.py to test your setup, while Graphviz remains optional for intricate graphs.

What it helps with

  • render wireframe mocks using Salt syntax
  • convert .puml source files into PNG or SVG assets
  • create network diagrams with nwdiag or WBS trees
  • swap raw PlantUML code blocks in Markdown for rendered image links

Example prompts for the agent

  • Generate a Salt wireframe for a settings page and save it as PNG
  • Convert the timing chart inside timing.puml to an SVG vector file
  • Extract all PlantUML fences from architecture.md and export images for Confluence

How to install plantuml

1Skills CLI (Vercel)

npx skills add SpillwaveSolutions/plantuml --skill plantuml -a claude-code

2Manually: put the files in place

~/.claude/skills/plantuml/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/plantuml/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about plantuml

How to install plantuml in Claude Code?

Run npx skills add SpillwaveSolutions/plantuml --skill plantuml -a claude-code in your terminal.

When should this skill be selected over Mermaid?

Pick it for diagrams unsupported by Mermaid syntax, such as UI Salt mockups, nwdiag layouts, timing waveforms, and ArchiMate structures.

What system dependencies are mandatory?

You need Java JRE/JDK 8 or newer and plantuml.jar placed in ~/plantuml.jar or specified via the PLANTUML_JAR variable. Graphviz is optional.

Similar skills

All skills for Writing and docs →

More in the catalog

Project sponsors

Companies that keep this analytics open