plantuml-sequence-diagram-generator

Generate PlantUML sequence diagrams with standardized styling, colors, and interaction patterns.

2|1|Updated Feb 12, 2026
One-click install
npx skills add https://github.com/cilerler/lillian --skill plantuml-sequence-diagram-generator-cilerler
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plantuml-sequence-diagram-generator
Source: https://github.com/cilerler/lillian/tree/main/plugins/ai-toolkit/skills/plantuml-sequence-diagram-generator
Command: npx skills add https://github.com/cilerler/lillian --skill plantuml-sequence-diagram-generator-cilerler

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Creating consistent, professional sequence diagrams by hand is slow and error-prone, with teams often producing diagrams that use inconsistent colors, arrow types, and note conventions. This Skill standardizes PlantUML sequence diagram generation so every service flow and API interaction diagram follows the same visual language. ## Core Features & Use Cases - Standardized Template Structure: Provides a reusable PlantUML template with headers, footers, versioning, legends, autonumbering, and phase separators. - Material Design Color System: Assigns consistent colors to participants (services, databases, queues, external systems) and control structures (loop, alt, opt, par, group). - Documented Interaction Patterns: Defines conventions for field documentation (hexnote), SQL queries (rnote), HTTP endpoints, arrow types, activation bars, and camelCase action verbs. - Use Case: When documenting a new microservice flow, ask the AI to generate a sequence diagram showing the portal, backend service, message queue, and database interactions, and receive a fully styled PlantUML diagram ready for architecture documentation. ## Quick Start Ask the AI to generate a PlantUML sequence diagram for your service flow, providing the company name, diagram title, participant groupings, and the interactions to visualize.

Frequently Asked Questions about plantuml-sequence-diagram-generator

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

FAQPage Schema
How do I create a PlantUML sequence diagram for a service flow?

Provide the company name, diagram title, participant groupings, and classification, then describe the interactions between components. The Skill generates a complete PlantUML diagram with standardized styling, autonumbering, phases, and a legend.

How to document fields and parameters in a PlantUML sequence diagram?

Use hexnote blocks placed above the sender before the arrow, with parameters prefixed by @, followed by ==== separators for unique IDs and update fields. Field names appear in double quotes with parameter values colored #795548.

What colors should I use for databases and queues in PlantUML diagrams?

This convention assigns purple (#E1BEE7, #CE93D8) to databases, orange/amber (#FFE0B2, #FFCC80) to messaging and queues, blue to your own services, and grey to external third-party systems, following Google Material Design palettes.

Can PlantUML sequence diagrams show SQL queries and HTTP endpoints?

Yes. SQL queries use rnote blocks over the database with grey-blue text, while HTTP endpoints show the actual method and route from the implemented API adapter. The diagram reflects the real implementation rather than inventing routes.

Why do hex notes appear in the wrong position in my sequence diagram?

Hex notes must be placed above the sender component and before the arrow, never on the receiver. Placing hnote after the message or over the receiving participant breaks the documentation convention and misattributes the fields.