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
npx skills add SpillwaveSolutions/plantuml --skill plantuml -a claude-codeWhat 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-code2Manually: put the files in place
~/.claude/skills/plantuml/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/plantuml/
1Skills CLI (Vercel)
npx skills add SpillwaveSolutions/plantuml --skill plantuml -a codex2Manually: put the files in place
.agents/skills/plantuml/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add SpillwaveSolutions/plantuml --skill plantuml -a cursor2Manually: put the files in place
.cursor/skills/plantuml/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install SpillwaveSolutions/plantuml plantuml2Manually: put the files in place
.github/skills/plantuml/SKILL.md1Skills CLI (Vercel)
npx skills add SpillwaveSolutions/plantuml --skill plantuml -a gemini-cli2Platform CLI
gemini skills install https://github.com/SpillwaveSolutions/plantumlManually: put the files in place
.devin/skills/plantuml/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add SpillwaveSolutions/plantuml --skill plantuml -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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.