uml-and-software-architecture-visualization

Design, render, and implement UML and software architecture diagrams from text-based sources.

5.3k|765|Updated Mar 4, 2026
One-click install
npx skills add https://github.com/openai/plugins --skill uml-and-software-architecture-visualization
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: uml-and-software-architecture-visualization
Source: https://github.com/openai/plugins/tree/main/plugins/build-web-data-visualization/skills/uml-and-software-architecture-visualization
Command: npx skills add https://github.com/openai/plugins --skill uml-and-software-architecture-visualization

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Choosing the right diagram notation, source format, renderer, and interaction model for software structure, behavior, and architecture is error-prone, and this Skill provides a structured decision workflow for UML and UML-like diagrams.

Core Features & Use Cases

  • Diagram Selection Guidance: Maps modeling questions to the right notation, covering sequence, class, state machine, activity, component, deployment, C4, ERD, BPMN, flowchart, and dependency diagrams.
  • Format and Renderer Expertise: Covers XMI/UMLDI interchange, PlantUML, Mermaid, Graphviz DOT, D2, Structurizr DSL, DBML, and BPMN XML, plus TypeScript renderers like React Flow, Cytoscape.js, Sprotty, JointJS, and GoJS.
  • Interactive Diagram Product Design: Provides patterns for explorers and editors including pan/zoom, search, filtering, drill-down, validation, accessibility, export, and testing.
  • Use Case: Ask for a C4 model of your application architecture, an ERD generated from a PostgreSQL schema in DBML, or an interactive React dependency diagram with ELK auto-layout.

Quick Start

Ask the assistant to design a sequence diagram for your OAuth login flow and recommend the best source format and renderer for your documentation site.

Frequently Asked Questions about uml-and-software-architecture-visualization

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

FAQPage Schema
How do I choose the right UML diagram for my system?

Match the diagram to the modeling question: sequence diagrams for message ordering, state machines for lifecycle rules, activity or swimlane diagrams for workflows, and C4 or deployment diagrams for architecture structure. Keep one abstraction level and one primary question per diagram.

Mermaid vs PlantUML vs Graphviz: which should I use for documentation?

Mermaid is the default for Markdown-friendly docs and quick web embeds, PlantUML offers broader formal UML coverage for CI pipelines, and Graphviz DOT suits dependency graphs and generated static layouts. D2 and Structurizr DSL fit polished architecture diagrams and C4 model-as-code.

How do I visualize a PostgreSQL schema as an ERD?

Introspect the SQL schema, then generate DBML, Mermaid ER, or PlantUML IE source and render to SVG or PNG. Route foreign keys through gutters attached to table-side ports so connectors never run beneath table boxes or column text.

What libraries work for interactive diagram editors in React?

React Flow suits editable node-edge UIs with custom components and ports, Cytoscape.js handles larger graphs and analysis, and JointJS or GoJS cover full-featured diagram editors. Pair them with ELK or Dagre for automatic layout.

Can XMI files be converted to PlantUML or Mermaid diagrams?

Yes, convert XMI into a normalized model preserving source IDs and stereotypes, then generate PlantUML, Mermaid, or DOT source. Expect vendor-specific extensions and partial semantic loss when moving between modeling tools.

When should I avoid force-directed layouts for architecture diagrams?

Avoid force layouts when process order or architecture hierarchy matters, since they obscure layered structure. Use layered or orthogonal layouts with ELK or Dagre for architecture, deployment, schema, and flow diagrams instead.