c4-architecture

Generate C4 Mermaid diagrams and Markdown documentation from user prompts.

Updated Apr 21, 2026
One-click install
npx skills add https://github.com/sertaoseracloud/sertao --skill c4-architecture-sertaoseracloud
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: c4-architecture
Source: https://github.com/sertaoseracloud/sertao/tree/main/.agents/skills/c4-architecture
Command: npx skills add https://github.com/sertaoseracloud/sertao --skill c4-architecture-sertaoseracloud

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Complex software architectures are hard to communicate clearly; this skill generates standardized C4 diagrams and accompanying Markdown documentation to align engineering and stakeholders.

Core Features & Use Cases

  • Generate C4Context, C4Container, C4Component, C4Deployment, and C4Dynamic diagrams in Mermaid syntax
  • Produce Markdown documentation that includes frontmatter metadata, usage notes, and references to C4 syntax
  • Apply across monoliths, microservices, and deployment architectures to support developers, architects, and product teams

Quick Start

Describe your system and request a full set of C4 diagrams and docs.

Frequently Asked Questions about c4-architecture

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

FAQPage Schema
What is the best way to document software architecture with C4 diagrams?

Documenting software architecture with C4 diagrams involves generating standardized Mermaid C4 diagrams and Markdown documentation from text prompts to align engineering teams and stakeholders.

How do I generate a C4 deployment diagram in Mermaid syntax?

You can generate a C4 deployment diagram in Mermaid syntax by providing a system description prompt, which produces C4Deployment diagrams alongside Markdown documentation with usage notes and syntax references.

Can I use C4 diagrams for microservices and monolith architectures?

Yes, C4 diagrams can be applied across both microservices and monolith architectures, generating Context, Container, Component, Deployment, and Dynamic views to support developers and product teams.

Does this approach support C4Dynamic and C4Component views?

Yes, the approach supports generating C4Dynamic and C4Component views, alongside C4Context and C4Container diagrams, enforcing Mermaid C4 syntax guidelines and frontmatter metadata in the output.

What is included in the Markdown documentation for system design?

The Markdown documentation for system design includes frontmatter metadata, usage notes, generated C4 Mermaid diagrams, and references to architecture best practices and C4 syntax guidelines.