plantuml-skill

# PlantUML Diagram Skill ## Overview Generate `.puml` PlantUML diagram files and export to PNG/SVG using **Kroki** — a cloud rendering API that requires no local installation beyond `curl`. **Format:** `.puml` (PlantUML text) **Renderer:** Kroki API (`https://kroki.io`) — just `curl`, no Java needed **Output:** PNG, SVG **Diagram types:** sequence, component, class, ER, activity, use case, state, C4, and more ## When to Use **Explicit triggers:** - "plantuml diagram", "sequence diagram", "class diagram", "component diagram" - "UML", "activity diagram", "use case diagram", "state machine" - "visualize", "draw", "diagram", "flowchart", "architecture chart" **Proactive triggers:** - Explaining a system with 3+ interacting components - Describing API flows, authentication sequences, message passing - Showing class hierarchies, database schemas, or ER models - Illustrating state machines or lifecycle flows **When NOT to use it — route elsewhere:** - General, non-UML quick diagrams embedded in Markdown → **mermaid**. - Freeform, heavily-styled, or branded diagrams needing pixel control → **drawio**. - A hand-drawn / sketchy look → **excalidraw** or **tldraw**. ## Modes Once triggered, route by what the user actually wants — then run the shared render loop (Steps 4–8): | Mode | The user wants… | Entry point | |---|---|---| | **Generate** (default) | a diagram from a text description | Steps 1–8 below | | **From code** | a diagram of existing source code | [`references/from...