plantuml

Generates PlantUML diagrams from conversation context as transparent PNG images.

Updated May 2, 2026
One-click install
npx skills add https://github.com/hdeshev/pi-config --skill plantuml-hdeshev
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: plantuml
Source: https://github.com/hdeshev/pi-config/tree/main/agent/skills/emacs-plantuml
Command: npx skills add https://github.com/hdeshev/pi-config --skill plantuml-hdeshev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning a discussion about architecture, flows, or data structures into a visual diagram normally requires manually writing PlantUML syntax and styling it to match your editor theme. This Skill automates that by deriving diagram content from the current conversation context and rendering it as a PNG that matches your Emacs color scheme. ## Core Features & Use Cases - Context-Driven Diagram Generation: Extracts diagrammable data from the recent conversation and chooses an appropriate diagram type (sequence, class, component, activity, state). - Theme-Aware Styling: Queries the Emacs default foreground color via emacsclient once per session and applies it to all PlantUML skinparam entries so diagrams are readable on your background. - Transparent PNG Output: Renders with a transparent background and outputs a markdown image reference that renders inline. - Use Case: After discussing a microservices message flow in chat, invoke /plantuml to get a sequence diagram PNG styled to your Emacs theme, ready to paste into notes or documentation. ## Quick Start Invoke /plantuml and ask it to create a sequence diagram of the workflow we just discussed.

Frequently Asked Questions about plantuml

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

FAQPage Schema
How do I create a PlantUML diagram from a conversation?▼

Invoke /plantuml after discussing the content you want visualized. The skill extracts diagrammable data from the recent context, writes a PlantUML file, runs the plantuml CLI, and outputs a markdown image pointing to the generated PNG.

How to make PlantUML diagrams match my Emacs theme?▼

The skill queries your Emacs default foreground color using emacsclient once per session, then applies that hex color to defaultFontColor and all relevant skinparam entries for borders, arrows, and text so the diagram is readable on your background.

What diagram types does PlantUML support?▼

PlantUML supports sequence, class, component, activity, and state diagrams, among others. The skill chooses an appropriate type based on the data found in the conversation context.

Does this skill work without Emacs running?▼

No, it depends on emacsclient to query the default foreground color for styling. Without a running Emacs server, the color query step cannot complete, though the plantuml CLI itself is also required for rendering.

What happens if there is nothing to diagram in the context?▼

If no diagrammable data exists in the recent conversation, the skill informs the user instead of producing an empty or meaningless diagram.