c4-architecture
Create software architecture documentation using C4 model diagrams rendered in Mermaid. The skill guides you through selecting the right abstraction level—from system context through deployment—and generates properly structured diagrams with clear relationships and technology labels.
C4 Architecture generates C4 model diagrams in Mermaid syntax for documenting software systems.
AI-generated summary based on this skill's SKILL.md
Install
softaworks/agent-toolkit/c4-architecture · repository language: Python
git clone https://github.com/softaworks/agent-toolkit
cp -r agent-toolkit/skills/c4-architecture ~/.claude/skills/c4-architectureFrequently asked questions
AI-generated answers based on this skill's SKILL.md and metadata
What is c4-architecture and what can it help me create?
c4-architecture is a skill for generating C4 model diagrams rendered in Mermaid that document your software architecture. It guides you through selecting the right abstraction level—from system context through deployment—and generates properly structured diagrams with clear relationships and technology labels to help teams understand system design.
How do I create a system context diagram with c4-architecture?
c4-architecture helps you generate system context diagrams by walking you through defining your system's boundary, external users, and external systems it interacts with. The skill produces a Mermaid-rendered diagram showing how your system fits into the broader landscape at the highest abstraction level.
Can c4-architecture generate container diagrams for documentation?
Yes. c4-architecture creates system container and container documentation for teams by helping you identify major containers (applications, databases, services) within your system and their interactions. It generates properly labeled diagrams showing technology choices and communication patterns between containers.
How does c4-architecture visualize software structure and relationships?
c4-architecture visualizes software structure and component relationships by guiding you through the C4 model's abstraction levels. It generates diagrams showing components within containers, their responsibilities, and how they interact, making complex architectures easier for teams to understand and document.
Can I use c4-architecture to document deployment topology?
Yes. c4-architecture supports documenting deployment topology and infrastructure nodes by generating deployment diagrams that show how containers are deployed across infrastructure environments. This helps teams understand the physical or cloud deployment architecture and technology stack.
Does c4-architecture support microservices architecture diagrams?
c4-architecture can model microservices and event-driven architectures by helping you map individual services as containers and their communication patterns. You can document how microservices interact, their boundaries, and deployment topology to create clear architecture documentation for distributed systems.
SKILL.md
rendered from the published skill — quoted content, verbatim
C4 Architecture Documentation
Generate software architecture documentation using C4 model diagrams in Mermaid syntax.
Workflow
- Understand scope - Determine which C4 level(s) are needed based on audience
- Analyze codebase - Explore the system to identify components, containers, and relationships
- Generate diagrams - Create Mermaid C4 diagrams at appropriate abstraction levels
- Document - Write diagrams to markdown files with explanatory context
C4 Diagram Levels
Select the appropriate level based on the documentation need:
| Level | Diagram Type | Audience | Shows | When to Create |
|---|---|---|---|---|
| 1 | C4Context |
(truncated - see the full file via the links below)
Read as markdown · JSON record · Browse the source repository
File tree — 5 files
skills/c4-architecture/README.md
skills/c4-architecture/SKILL.md
skills/c4-architecture/references/advanced-patterns.md
skills/c4-architecture/references/c4-syntax.md
skills/c4-architecture/references/common-mistakes.md