c4-architecture

Document software architectures with C4 model Mermaid diagrams.

264|11|Updated Apr 25, 2026
One-click install
npx skills add https://github.com/rkz91/coco --skill c4-architecture-rkz91
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: c4-architecture
Source: https://github.com/rkz91/coco/tree/main/skills/c4-architecture
Command: npx skills add https://github.com/rkz91/coco --skill c4-architecture-rkz91

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This frontmatter-driven guide helps teams generate clear, standardized architecture diagrams using the C4 model and Mermaid, turning complex software landscapes into approachable visuals.

Core Features & Use Cases

  • Generate System Context, Container, Component, and Deployment diagrams in Mermaid syntax.
  • Produce accompanying documentation that explains decisions, boundaries, and the architecture narrative.
  • Apply across projects to visualize architecture, document changes, and support ADRs with consistent notation.

Quick Start

Provide a sample system description and request a System Context diagram using Mermaid C4, then extend to Container and Component diagrams as needed.

Frequently Asked Questions about c4-architecture

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

FAQPage Schema
What is the C4 model for software architecture documentation?

The C4 model documents software architecture through four abstraction levels: system context, containers, components, and deployment. It provides consistent notation and boundaries to communicate complex software landscapes as approachable, shareable visuals across varied project scopes.

How do I generate Mermaid diagrams for system context and containers?

Provide a sample system description to generate Mermaid C4 diagrams, starting with a system context diagram, then extending to container and component diagrams. This produces clear notations, boundaries, and naming conventions for each abstraction level.

Can I use C4 diagrams to support architecture decision records?

Yes, C4 diagrams support architecture decision records by providing consistent, shareable architecture visuals. The accompanying documentation explains decisions and boundaries, creating a clear architecture narrative that strengthens ADRs across projects.

What's the best way to document software deployments using Mermaid?

Use the C4 model deployment diagram level in Mermaid syntax to document software deployments. This approach produces clear deployment visuals with consistent notation and boundaries, communicating infrastructure relationships across varied project scopes.

Do I need any specific tools to create C4 architecture diagrams?

No specific tools or dependencies are required to create C4 architecture diagrams. The skill generates Mermaid syntax directly, which can be rendered in standard markdown viewers and documentation platforms without additional software installations.

When should I not use the C4 model for architecture documentation?

The C4 model may be excessive for simple applications with minimal system boundaries or few components. It is designed for teams needing consistent, shareable architecture visuals across varied project scopes, where multiple abstraction levels aid communication.