plantuml

Generate and render PlantUML diagrams from Markdown and code.

46|8|Updated Jan 22, 2026
One-click install
npx skills add https://github.com/SpillwaveSolutions/code_agent_context_hooks --skill plantuml
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plantuml
Source: https://github.com/SpillwaveSolutions/code_agent_context_hooks/tree/main/.opencode/skill/plantuml
Command: npx skills add https://github.com/SpillwaveSolutions/code_agent_context_hooks --skill plantuml

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires plantuml.jar, Graphviz, Python, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This skill automates the generation and publication-ready rendering of PlantUML diagrams from text descriptions, Markdown content, and code.

Core Features & Use Cases

  • Generate diagrams from natural language for all 19 PlantUML diagram types (UML and non-UML).
  • Extract PlantUML diagrams from Markdown (embedded code blocks and linked .puml files) and convert to PNG/SVG.
  • Process Markdown for Confluence/Notion by replacing diagrams with image links and validating syntax.
  • Unicode symbol enrichment to improve semantic clarity and readability.

Quick Start

To get started, check your environment, then process Markdown or code to diagrams:

  • Check environment: python scripts/check_setup.py
  • Process a Markdown file with embedded and linked diagrams: python scripts/process_markdown_puml.py article.md
  • Convert a standalone PlantUML file: java -jar plantuml.jar diagram.puml
  • Generate an SVG image: java -jar plantuml.jar -tsvg diagram.puml

Frequently Asked Questions about plantuml

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

FAQPage Schema
How do I convert PlantUML code to PNG or SVG images for Confluence?

You can convert PlantUML diagrams to PNG or SVG images by running the PlantUML JAR on standalone .puml files or using the Python Markdown processing scripts to extract embedded code blocks and render publication-ready images suitable for Confluence.

Can I generate UML diagrams from natural language text descriptions?

Yes, you can generate diagrams from natural language text descriptions. This skill supports automated diagram generation for all 19 PlantUML diagram types, covering both standard UML and non-UML visualizations directly from your text input.

Do I need Java and Graphviz installed to render PlantUML diagrams?

Yes, you need Java, Graphviz, and the PlantUML JAR installed to render PlantUML diagrams. The skill also relies on Python-based scripts for Markdown processing and on-demand resource loading to automate the generation workflow.

How do I extract and process PlantUML diagrams embedded in Markdown files?

To extract and process PlantUML diagrams embedded in Markdown files, run the Python-based process_markdown_puml.py script. It parses Markdown content, extracts embedded code blocks and linked .puml files, and converts them to images.

What is the best way to process Markdown for Confluence and replace diagrams with image links?

The best way to process Markdown for Confluence is using the Python processing scripts. They validate PlantUML syntax, replace embedded diagrams with image links, and ensure the Markdown output is formatted correctly for Confluence or Notion.

Does PlantUML support all 19 diagram types including non-UML diagrams?

Yes, PlantUML supports all 19 diagram types including both standard UML diagrams and non-UML diagrams. The skill automates the generation and publication-ready rendering of all these diagram types from text descriptions and code.