# plantuml

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

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 3 installs · ★ 61 repo stars
- Author: SpillwaveSolutions
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/SpillwaveSolutions/plantuml/tree/HEAD/SKILL.md
- Updated: 2026-08-24
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/plantuml

## What it 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.

## Requirements
- Works with: GitHub, Confluence

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add SpillwaveSolutions/plantuml --skill plantuml -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/plantuml/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/plantuml/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add SpillwaveSolutions/plantuml --skill plantuml -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/plantuml/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add SpillwaveSolutions/plantuml --skill plantuml -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/plantuml/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install SpillwaveSolutions/plantuml plantuml
```

2. **Manually: put the files in place**
- File: `.github/skills/plantuml/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add SpillwaveSolutions/plantuml --skill plantuml -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/SpillwaveSolutions/plantuml
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/plantuml/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add SpillwaveSolutions/plantuml --skill plantuml -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/SpillwaveSolutions/plantuml/tree/HEAD/SKILL.md

## When to use it
- 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
- 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

## Similar
- [plantuml-skill](https://affpapa.org/en/nevibecode/skills/plantuml-skill.md) — skill · 4200 installs
- [PlantUML Diagrams](https://affpapa.org/en/nevibecode/mcp/plantuml-diagrams.md) — MCP server · 1819 installs
- [design-doc-mermaid](https://affpapa.org/en/nevibecode/skills/design-doc-mermaid.md) — skill · 101800 installs
- [plantuml-ascii](https://affpapa.org/en/nevibecode/skills/plantuml-ascii.md) — skill · 9740 installs
- [plantuml-diagram-generator](https://affpapa.org/en/nevibecode/skills/plantuml-diagram-generator.md) — skill · 123 installs
- [tldraw-skill](https://affpapa.org/en/nevibecode/skills/tldraw-skill.md) — skill · 3800 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
