architecture-diagramming

Create Mermaid architecture diagrams with structured visualization standards.

Updated May 15, 2026
One-click install
npx skills add https://github.com/avgarcia/runcriticon --skill architecture-diagramming-avgarcia
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture-diagramming
Source: https://github.com/avgarcia/runcriticon/tree/main/.claude/skills/architecture-diagramming
Command: npx skills add https://github.com/avgarcia/runcriticon --skill architecture-diagramming-avgarcia

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps teams avoid confusing and inconsistent architecture diagrams by providing standards for creating understandable visual representations of software systems.

Core Features & Use Cases

  • C4 and UML Diagram Guidance: Defines how to create context, container, component, sequence, ERD, state, and deployment diagrams using Mermaid.
  • Architecture Documentation Standards: Ensures diagrams include proper scope, labels, legends, metadata, and consistent notation for different audiences.
  • Use Case: Use this Skill when documenting a new system architecture, updating technical design documents, or explaining infrastructure and software boundaries to stakeholders.

Quick Start

Ask the architecture diagramming skill to create a Mermaid C4 container diagram for the system architecture with clear labels and a legend.

Frequently Asked Questions about architecture-diagramming

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

FAQPage Schema
How do I create consistent architecture diagrams using Mermaid?

To create consistent architecture diagrams using Mermaid, apply structured visualization standards that require explicit labels, metadata, legends, and audience-focused abstraction levels to ensure clear visual representations of software systems.

What is the C4 model and when should I use it for software documentation?

The C4 model is a structured visualization standard for software architecture documentation that uses different abstraction levels—context, container, and component diagrams—to explain software boundaries to specific audiences.

Can I use Mermaid to generate UML sequence and ERD diagrams?

Yes, you can use Mermaid to generate UML sequence and ERD diagrams. The architecture documentation standards support sequence, ERD, state, and deployment diagrams using Mermaid-based conventions.

What's the best way to document system architecture for different stakeholders?

The best way to document system architecture for stakeholders is applying audience-focused abstraction levels with consistent notation, scope definitions, and validation checklists to ensure understandable visual representations.

How do I validate that my software architecture diagrams have proper scope and notation?

You validate software architecture diagrams by applying validation checklists that verify proper scope, explicit labels, legends, metadata, and consistent Mermaid-based notation across different audience abstraction levels.