mcpField
P
plantuml

plantuml

github.com/xenodiumDevelopment14861 installsUpdated 14w ago
Repository

About plantuml

A skill that turns the recent interaction context into a PlantUML diagram and renders it as a transparent PNG. It uses the Emacs foreground color to style diagram text and elements.

Key features

  1. 01Derive diagrams from conversation context
  2. 02Generate PlantUML diagrams
  3. 03Render transparent PNG images
  4. 04Apply Emacs foreground color

Use cases

  1. 01Visualize a process discussed in chat
  2. 02Diagram relationships in contextual data

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/xenodium/emacs-skills --skill plantuml

After installing, type/plantumlin Claude Code to confirm it loaded.

Details

From the project README

Create diagrams with PlantUML

Create a diagram from the most recent interaction context using PlantUML. Generate a PNG image with a transparent background and output it as a markdown image so it renders inline.

How to create a diagram

  1. Extract or derive diagrammable data from the current context.
  2. If the Emacs foreground color is not already known from a previous diagram in this session, query it: 
    emacsclient --eval '
(face-foreground (quote default))'
    This returns a hex color like "#eeffff". Reuse it for all subsequent diagrams.
  3. Write a PlantUML file to a temporary file using that color.
  4. Run PlantUML on the file.
  5. Output the result as a markdown image on its own line: 
    ![description](/tmp/agent-diagram-XXXX.png)

plantuml -tpng /tmp/agent-diagram-XXXX.puml

PlantUML template

@startuml
skinparam backgroundColor transparent
skinparam shadowing true
skinparam roundcorner 10
skinparam defaultFontName "Helvetica"
skinparam defaultFontColor #eeffff

' Set foreground color on all element types
skinparam titleFontColor #eeffff
skinparam sequenceLifeLineBorderColor #eeffff
skinparam sequenceArrowColor #eeffff
skinparam sequenceGroupHeaderFontColor #eeffff
skinparam sequenceGroupBorderColor #eeffff
skinparam sequenceDividerFontColor #eeffff
skinparam sequenceDividerBorderColor #eeffff
skinparam actorBorderColor #eeffff
skinparam actorFontColor #eeffff
skinparam participantFontColor #eeffff
skinparam participantBorderColor #eeffff
skinparam collectionsFontColor #eeffff
skinparam collectionsBorderColor #eeffff
skinparam noteFontColor #eeffff
skinparam noteBorderColor #eeffff
skinparam arrowFontColor #eeffff
skinparam classFontColor #eeffff
skinparam classBorderColor #eeffff
skinparam classAttributeFontColor #eeffff
skinparam packageFontColor #eeffff
skinparam packageBorderColor #eeffff
skinparam componentFontColor #eeffff
skinparam componentBorderColor #eeffff
skinparam interfaceFontColor #eeffff
skinparam interfaceBorderColor #eeffff

' ... diagram content ...
@enduml

Rules

  • Query the Emacs foreground color once per session and reuse it for all subsequent diagrams. Only query again if the color is not already known.
  • Always use skinparam backgroundColor transparent for transparent background.
  • Always use a timestamp in the filename (e.g., /tmp/agent-diagram-$(date +%s).png). Never use descriptive names.
  • Set the queried foreground color on defaultFontColor and all relevant skinparam entries for borders, arrows, and text so the diagram is readable on the user's Emacs background.
  • After PlantUML runs successfully, output a markdown image (![description](path)) on its own line.
  • Choose an appropriate diagram type for the data (sequence, class, component, activity, state, etc.).
  • Include a title when it adds clarity.
  • If no diagrammable data exists in the recent context, inform the user.

Comments

Markdown supported