Agent skill · design visual · aiskillstore

c4-modeling

C4 architectural modeling for documenting software architecture. Use when creating architecture diagrams, planning new systems, communicating with stakeholders, or conducting architecture reviews.

Why this skill is useful

Provides specific guidelines and syntax for creating C4 architecture diagrams that the AI wouldn't reliably generate on its own.

What it needs

About 2k tokens when loaded. Last updated 2026-08-07. 405 stars on the source repository.

What this skill does

C4 Modeling Skill Create hierarchical architecture diagrams at four abstraction levels using the C4 model and Mermaid syntax. Variables Variable Default Description ---------- --------- ------------- DEFAULTLEVEL context Start with context, container, component, or code OUTPUTFORMAT mermaid mermaid, structurizr, plantuml INCLUDELEGEND true Add legend to diagrams Instructions MANDATORY - Follow the Workflow steps below when creating C4 diagrams. Always start at Level 1 (Context) and zoom in as needed Never mix abstraction levels in a single diagram Include descriptions for all elements Red Flags - STOP and Reconsider If you're about to: Create a container diagram without first creating a context diagram Mix containers and components in the same diagram Show implementation details at the context level Create a code-level diagram for non-critical code STOP -> Check the appropriate level guidelines in reference/level-guidelines.md -> Then proceed Workflow 1. [ ] Determine the audience and purpose 2. [ ] CHECKPOINT: Start at Level 1 (Context) unless you have higher-level diagrams 3. [ ] Identify all actors and systems at current level 4. [ ] Define relationships with labeled arrows 5. [ ] Add technology choices (for Level 2+) 6. [ ] CHECKPOINT: Verify you haven't mixed abstraction levels 7. …

How to use it

Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:

@skills aiskillstore/c4-modeling

View the source on GitHub

Browse the @skills marketplace