c4-architecture

Generate C4 model architecture diagrams in Mermaid for context, container, component, and deployment levels.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/albertms22/agent-toolkit --skill c4-architecture-albertms22
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: c4-architecture
Source: https://github.com/albertms22/agent-toolkit/tree/main/skills/c4-architecture
Command: npx skills add https://github.com/albertms22/agent-toolkit --skill c4-architecture-albertms22

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Create clear, standardized architecture diagrams using the C4 model in Mermaid to document systems at context, container, component, and deployment levels.

Core Features & Use Cases

  • Generate Context, Container, Component, Deployment, and Dynamic diagrams with consistent notation.
  • Align diagrams to audience needs (Executives, Developers, DevOps) and promote best practices.
  • Provide quick-start guidance and a structure for integrating diagrams into documentation.

Quick Start

Create a set of Mermaid-based C4 diagrams for a given system, starting with a System Context and Container diagram, then add Component and Deployment as needed.

Frequently Asked Questions about c4-architecture

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

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

To create C4 architecture diagrams using Mermaid, you generate context, container, component, and deployment diagrams with consistent notation. This approach provides ready-to-use outputs for your documentation by enforcing necessary elements like names, descriptions, technologies, and relationships.

What is the best way to document system architecture for different audiences?

The best way to document system architecture for different audiences is selecting appropriate C4 diagram levels. You start with a System Context diagram for executives, add Container diagrams for developers, and include Component or Deployment diagrams for DevOps to ensure clear communication.

When do I need a deployment diagram in my architecture documentation?

You need a deployment diagram in your architecture documentation when detailing infrastructure mapping for DevOps teams. It complements context, container, and component diagrams by showing how software elements are deployed across physical or virtual environments.

Does Mermaid support all C4 model levels for software documentation?

Yes, Mermaid supports generating all standard C4 model levels including context, container, component, and deployment diagrams. This allows you to document software architecture comprehensively within a single syntax framework for easy integration.