uml-diagrams

Generate PlantUML and Mermaid UML diagrams with correct notation.

5|1|Updated Jun 17, 2026
One-click install
npx skills add https://github.com/roanbrasil/engineer-grade-agent-skills --skill uml-diagrams
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: uml-diagrams
Source: https://github.com/roanbrasil/engineer-grade-agent-skills/tree/main/skills/uml-diagrams
Command: npx skills add https://github.com/roanbrasil/engineer-grade-agent-skills --skill uml-diagrams

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Software teams often struggle to align on design decisions due to inconsistent, unclear, or incomplete visual documentation of system structure and behavior, leading to implementation errors and rework.

Core Features & Use Cases

  • Multi-diagram support: Covers the 5 most practical UML diagram types (class, sequence, state machine, activity, use case) with a clear selection guide to match your design question to the right diagram.
  • Dual tool compatibility: Provides ready-to-use, syntax-correct examples for both PlantUML and Mermaid, so you can generate diagrams in your team's preferred tool without learning complex notation from scratch.
  • Real-world use case: When designing an e-commerce order flow, use this skill to quickly generate a sequence diagram showing API interactions between the customer, order service, and payment gateway to align stakeholders on the flow before writing code.

Quick Start

Use the uml-diagrams skill to generate a PlantUML class diagram for your e-commerce order domain model, including the Order, LineItem, and OrderRepository entities with their relationships and multiplicity.

Frequently Asked Questions about uml-diagrams

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

FAQPage Schema
How do I generate PlantUML and Mermaid diagrams for software design?

To generate PlantUML and Mermaid diagrams for software design, use this skill to produce syntax-correct notations. It provides standardized guidance for creating valid class, sequence, and state machine diagrams while avoiding common anti-patterns.

What is the best way to document domain modeling and API contracts?

Documenting domain modeling and API contracts is best achieved using standardized UML diagrams. This skill provides templates for sequence and class diagrams to align stakeholders on system structure, entity lifecycles, and behavior before implementation.

Which UML diagram types should I use for state machine and activity modeling?

For state machine and activity modeling, you should use UML state machine and activity diagrams. This skill supports the five most practical UML diagram types and includes a selection guide to match your specific design question to the correct diagram.

Does this tool support both PlantUML and Mermaid syntax for sequence diagrams?

Yes, this skill supports both PlantUML and Mermaid syntax for sequence diagrams. It offers dual tool compatibility with ready-to-use, syntax-correct examples so you can generate diagrams in your team's preferred tool without learning complex notation.

How do I avoid anti-patterns when creating class diagrams for an e-commerce order flow?

To avoid anti-patterns when creating class diagrams for an e-commerce order flow, apply this skill's best practice guidance. It ensures correct notation and relationship types for entities like Order and LineItem, eliminating inconsistent software design documentation.