Agent skill · magnus919
c4-diagramming
Create C4 software-architecture diagrams using Mermaid or Structurizr. Use when teams need clear system context, container, component, or code-level views.
What it needs
About 3k tokens when loaded.
What this skill does
C4 Diagramming C4 Model for structural architecture visualization. Produces diagrams at four zoom levels, mapped into the artifact pyramid. C4-to-Pyramid Mapping C4 Level Pyramid Layer Path ---------- -------------- ------ Level 1: System Context L1 (Summary) 01-summary/system-context.md Level 2: Container L2 (Analysis) 02-analysis/structural-views/container.md Level 3: Component L2 (Analysis) 02-analysis/structural-views/components.md Level 4: Code L3 (Dossiers) 03-dossiers/code-level-detail.md C4 is the cleanest structural fit — its four-level hierarchy maps to the three pyramid layers with almost no translation, and Levels 2-3 both resolve to separate L2 analysis files. Authoring Formats Mermaid (Default for Quick Diagrams) Use when you need a single diagram embedded in markdown. See the GitHub Rendering Constraint section below for C4-in-Mermaid compatibility notes. Structurizr DSL (Recommended for Long-Lived Projects) Structurizr DSL is the C4 model's reference "models as code" implementation, created by Simon Brown. Define the entire architecture model in a single DSL file; all 4 C4 levels are generated from it. This ensures structural consistency across diagrams that hand-written Mermaid cannot guarantee. Key capabilities: !adrs docs/adr — imports Architecture Decision Records (adr-tools, MADR, log4brains) into the workspace, rendered alongside C4 diagrams !docs docs/arc42 — imports arc42 documentation as Markdown/AsciiDoc Structurizr Lite (Docker) — local preview at http://localhost:8081 CI commands: validate, inspect, export (PlantUML, Mermaid, static site) Full reference in references/architecture-as-code-ecosystem.md — tool comparison, DSL cookbook, C4-PlantUML alternative, and the converged repo convention. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills magnus919/c4-diagramming