Diagram Types Quick Reference

Type	Keywords	Best For
Sequence	`@startuml`	Interactions, API flows, protocols
Use Case	`@startuml`	Requirements, user stories
Class	`@startuml`	OOP design, domain models
Activity	`@startuml`	Workflows, processes
Component	`@startuml`	System structure
Deployment	`@startuml`	Infrastructure, deployment
State	`@startuml`	State machines

Type	Keywords	Best For
JSON	`@startjson`	JSON structure visualization
YAML	`@startyaml`	YAML structure visualization
Wireframe	`@startsalt`	UI mockups
Gantt	`@startgantt`	Project timelines
MindMap	`@startmindmap`	Hierarchical ideas
WBS	`@startwbs`	Work breakdown
ER	`@startuml`	Database schemas
C4	`@startuml` with C4 include	Software architecture

Basic Syntax

All PlantUML diagrams are wrapped in start/end tags:

@startuml
' Your diagram code here
@enduml

Comments:

Title and captions:

@startuml
title My Diagram Title
caption This is a caption
header Page Header
footer Page Footer

' Diagram content
@enduml

@startuml
participant A
participant B
A -> B: Message
A <-- B: Response
@enduml

@startuml
class Name {
    - private
    + public
    + method()
}
A <|-- B : extends
A *-- B : contains
@enduml

@startuml
start
:Action;
if (condition?) then (yes)
    :True path;
else (no)
    :False path;
endif
stop
@enduml

@startuml
[*] --> State1
State1 --> State2 : event
State2 --> [*]
@enduml

@startuml
[Component1] --> [Component2]
database DB
Component2 --> DB
@enduml

For detailed syntax and complete examples, see:

Reference	Content	When to Load
sequence.md	Participants, arrows, activation, groups, notes	Creating sequence diagrams
class.md	Classes, visibility, relationships, cardinality	Creating class diagrams
activity.md	Conditions, swimlanes, fork/join	Creating activity diagrams
state-component.md	State machines, components, deployment	Creating state/component diagrams
c4.md	C4 context, container, component diagrams	Creating C4 architecture diagrams
special-diagrams.md	ER, JSON, MindMap, Gantt	Creating non-UML diagrams
styling-setup.md	Skinparams, themes, installation	Customizing diagrams, setting up PlantUML

Query: "Create a PlantUML sequence diagram for user authentication"

Expected: Skill activates, provides sequence syntax with participants, arrows, and alt/else blocks

Query: "Generate a PlantUML class diagram for an e-commerce domain"

Expected: Skill activates, provides class syntax with relationships and cardinality

Query: "Create a C4 container diagram in PlantUML"

Expected: Skill activates, directs to c4.md reference for includes and syntax

Last Updated: 2025-12-28 PlantUML Version: 1.2024.6

v1.1.0 (2025-12-28): Refactored to progressive disclosure - extracted content to references/
v1.0.0 (2025-12-26): Initial release