What is the C4 model used in this skill?

The C4 model is a lean graphical notation technique for modelling the architecture of software systems through four levels: Context, Containers, Components, and Code.

Can this skill create dynamic request flow diagrams?

Yes, it supports C4Dynamic diagrams which allow you to visualize specific request flows, message sequences, and interactions between elements.

Where are the architecture diagrams stored?

The skill follows a convention of writing documentation to the docs/architecture/ directory, using Markdown files with embedded Mermaid syntax.

Does this skill support microservices and event-driven patterns?

Absolutely. It includes specific guidelines for modeling microservices as containers or systems and representing event-driven message brokers like Kafka.

Are the diagrams compatible with GitHub and GitLab?

Yes, because the skill uses Mermaid syntax, the diagrams will render natively in Markdown files on platforms like GitHub, GitLab, and Azure DevOps.

C4 Architecture Documentation

Name: C4 Architecture Documentation
Author: softaworks

bysoftaworks

•

347

•

Learning & Documentation

Generates standardized software architecture diagrams using the C4 model and Mermaid syntax to visualize system structure and relationships.

This skill empowers AI coding agents to create professional-grade architectural documentation based on the industry-standard C4 model. By analyzing codebases and system requirements, it generates Mermaid-based diagrams across multiple levels of abstraction—System Context, Containers, Components, and Deployment—alongside dynamic request flow visualizations. It helps development teams align on technical strategy, simplify complex system onboarding, and maintain living documentation directly within their repositories using a structured, human-readable format.

Key Features

01Visualizes system context, containers, components, and infrastructure nodes

02Follows industry best practices for architectural clarity and tech-stack labeling

03347 GitHub stars

04Automated Mermaid diagram generation for C4 Model levels 1 through 4

05Creates dynamic request flow diagrams for complex event-driven workflows

06Organizes documentation into a structured directory with standardized naming conventions

Use Cases

01Documenting legacy codebases to identify system boundaries and external dependencies

02Designing new microservices architectures during the planning and RFC phase

03Visualizing production infrastructure and deployment environments for DevOps alignment

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add softaworks/agent-toolkit c4-architecture

For use in Claude.ai and ChatGPT

Download Skill