architecture-diagram

Generate C4 model Mermaid or PlantUML diagrams from system components and audience.

3|Updated May 28, 2026
One-click install
npx skills add https://github.com/mahg-es/araya --skill architecture-diagram-mahg-es
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture-diagram
Source: https://github.com/mahg-es/araya/tree/main/skills/architecture-diagram
Command: npx skills add https://github.com/mahg-es/araya --skill architecture-diagram-mahg-es

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Architecture without diagrams is invisible. Stakeholders can't understand systems they can't see. This skill creates diagrams at the right level of abstraction for each audience — executives need context; developers need components.

Core Features & Use Cases

  • Mermaid diagrams by default for version-controlled, text-based architecture diagrams (Context, Container, Component).
  • Supports C4-PlantUML compatibility and data-flow diagrams for behavior.
  • Useful for architecture documentation, ADRs, onboarding, and design reviews.

Quick Start

Provide system architecture details, audience, and diagram type to generate a Mermaid or PlantUML diagram.

Frequently Asked Questions about architecture-diagram

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

FAQPage Schema
How do I generate a Mermaid architecture diagram for my system?

To generate a Mermaid architecture diagram, provide your system components, target audience, and desired diagram type. The skill outputs text-based diagrams aligned with the C4 model, suitable for version control and documentation.

What is the C4 model and when do I need it for architecture documentation?

The C4 model structures architecture visualization into context, container, and component levels. You need it to present system designs at the right abstraction for different audiences, from executives needing high-level context to developers needing detailed components.

Can I use PlantUML instead of Mermaid for C4 model diagrams?

Yes, you can generate PlantUML diagrams as an alternative to the default Mermaid output. By specifying PlantUML compatibility, the skill produces text-based C4-PlantUML syntax suitable for version-controlled architecture documentation and ADRs.

How do I create data-flow diagrams for architecture design reviews?

You can create data-flow diagrams by supplying your system components and specifying the data-flow diagram type. This visualizes system behavior and interactions, which is useful for architecture documentation, onboarding, and design reviews.

Does this approach work for documenting Architecture Decision Records?

Yes, this approach works for Architecture Decision Records by providing text-based Mermaid or PlantUML visualizations. It generates diagrams at appropriate abstraction levels to support the architectural context and decisions documented within the ADR.

What inputs do I need to produce a context diagram for executives?

To produce a context diagram for executives, you need to supply the system components, specify the executive audience, and select the context diagram type. The output is a high-level text-based visualization suitable for version control.