arch-uml

Create and render UML diagrams as SVG files using PlantUML and Docker.

Updated Apr 8, 2026
One-click install
npx skills add https://github.com/VictorHueni/homemade-claude-kit --skill arch-uml
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: arch-uml
Source: https://github.com/VictorHueni/homemade-claude-kit/tree/main/skills/arch-uml
Command: npx skills add https://github.com/VictorHueni/homemade-claude-kit --skill arch-uml

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires plantuml, docker, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill streamlines the creation and rendering of UML diagrams using PlantUML, making it easy to visualize complex software designs and architectural models.

Core Features & Use Cases

  • UML Diagram Authoring: Generate sequence, class, state, activity, ER, and use-case diagrams.
  • PlantUML Integration: Leverages PlantUML for detailed UML diagramming capabilities.
  • Automated Rendering: Utilizes a Docker pipeline to automatically render diagrams as SVG files.
  • Embedding: Seamlessly embed diagrams into markdown documentation for easy reference.

Quick Start

To create a sequence diagram, run the command: arch-uml create sequence <name> <description>

Frequently Asked Questions about arch-uml

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

FAQPage Schema
How do I generate UML diagrams from PlantUML automatically?

To generate UML diagrams automatically, this Skill uses a Docker pipeline to render PlantUML syntax into SVG files. It automates the creation of sequence, class, state, activity, ER, and use-case diagrams without manual rendering steps.

What do I need to install to render PlantUML diagrams?

You need both PlantUML and Docker installed to render PlantUML diagrams using this Skill. The automated rendering pipeline relies on Docker to process the PlantUML syntax and output the final SVG files.

Can I embed UML diagrams into markdown documentation?

Yes, you can embed UML diagrams into markdown documentation. The Skill integrates rendered SVG files seamlessly into your markdown files, allowing you to visualize complex software designs and architectural models directly alongside your text.

How do I create a sequence diagram using PlantUML?

To create a sequence diagram, run the command: arch-uml create sequence <name> <description>. This initiates the PlantUML diagramming process, authoring the sequence diagram and preparing it for automated rendering via the Docker pipeline.

What is the best way to visualize software architecture with UML?

The best way to visualize software architecture with UML is using PlantUML to author models and a Docker pipeline to render them. This approach supports multiple diagram types like class and ER diagrams, ensuring detailed visualization of complex designs.

Are there limitations when using Docker for UML rendering?

The primary limitation of using Docker for UML rendering is the strict dependency on having Docker installed. If your environment lacks Docker or PlantUML, the automated rendering pipeline cannot execute to produce the SVG files.