Generates structured C4 model architecture documentation using Mermaid diagrams.
Install
mkdir -p .claude/skills/c4-architecture-documentation && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/10486" && unzip -o skill.zip -d .claude/skills/c4-architecture-documentation && rm skill.zipInstalls to .claude/skills/c4-architecture-documentation
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
Document system architecture using C4 model with context, container, component views and Mermaid diagramsKey capabilities
- →Document system context
- →Create container diagrams
- →Generate component views
- →Build architectural decision records
How it works
Uses the C4 model framework and Mermaid diagrams to visualize system architecture at different levels of abstraction.
Inputs & outputs
When to use c4-architecture-documentation
- →Documenting system context views
- →Creating container and component diagrams
- →Generating security architecture documentation
- →Building architectural decision records
About this skill
C4 Architecture Documentation Skill
Purpose
Document MCP server architecture using C4 model for different abstraction levels with Mermaid diagrams.
When to Use
- ✅ Documenting system architecture (ARCHITECTURE.md)
- ✅ Security architecture documentation (SECURITY_ARCHITECTURE.md)
- ✅ Future architecture planning (FUTURE_ARCHITECTURE.md)
- ✅ Architecture decision records
- ✅ Onboarding new developers
Required Documentation Portfolio
Current State
| Document | Purpose |
|---|---|
| ARCHITECTURE.md | Complete C4 models (Context, Container, Component) |
| DATA_MODEL.md | Data structures, entities, relationships |
| FLOWCHART.md | Business process and data flows |
| STATEDIAGRAM.md | System state transitions and lifecycles |
| MINDMAP.md | System conceptual relationships |
| SWOT.md | Strategic analysis and positioning |
| SECURITY_ARCHITECTURE.md | Current security design and controls |
Future State
| Document | Purpose |
|---|---|
| FUTURE_ARCHITECTURE.md | Architectural evolution roadmap |
| FUTURE_DATA_MODEL.md | Enhanced data architecture plans |
| FUTURE_FLOWCHART.md | Improved process workflows |
| FUTURE_STATEDIAGRAM.md | Advanced state management |
| FUTURE_MINDMAP.md | Capability expansion plans |
| FUTURE_SWOT.md | Future strategic opportunities |
| FUTURE_SECURITY_ARCHITECTURE.md | Planned security improvements |
C4 Model Levels
Level 1: System Context
graph TB
User[AI Assistant/Developer] -->|MCP Protocol| Server[European Parliament MCP Server]
Server -->|REST API| EPAPI[European Parliament Open Data API]
Server -->|JSON-LD| EPData[EP Data Portal]
Level 2: Container Diagram
graph TB
Client[MCP Client] -->|stdio/SSE| MCPServer[MCP Server - Node.js/TypeScript]
MCPServer -->|HTTP/JSON| EPClient[EP API Client]
EPClient -->|REST| EPAPI[data.europarl.europa.eu]
MCPServer -->|Zod| Schemas[Validation Schemas]
Level 3: Component Diagram
graph TB
Tools[MCP Tools] --> Client[EP API Client]
Resources[MCP Resources] --> Client
Prompts[MCP Prompts] --> Client
Client --> Cache[LRU Cache]
Client --> RateLimiter[Rate Limiter]
Client --> Validator[Zod Schemas]
Mermaid Diagram Standards
- Use
graph TBfor top-bottom flow diagrams - Use
sequenceDiagramfor interaction flows - Use
stateDiagram-v2for state machines - Use
mindmapfor conceptual relationships - Include legends and descriptions
ISMS Policy References
- Secure Development Policy - Architecture documentation requirements
- Information Security Policy - Security architecture governance
When not to use it
- →When documenting non-system architecture
- →When simple text documentation suffices
Limitations
- →Requires adherence to C4 model levels
- →Mermaid diagrams are limited by text-based rendering
How it compares
Standardizes architectural documentation across projects rather than using ad-hoc diagramming.
Compared to similar skills
c4-architecture-documentation side by side with the closest alternatives in the catalog.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| c4-architecture-documentation (this skill) | 0 | 5mo | No flags | Intermediate |
| adr | 0 | 4mo | No flags | Beginner |
| wiki-page-writer | 5 | 3mo | No flags | Advanced |
| business-knowledge-workflow | 1 | 3mo | No flags | Intermediate |
Try saying
Example prompts that trigger this skill in your AI assistant.
More by Hack23
View all by Hack23 →You might also like
adr
landphieran
Record an Architecture Decision Record (ADR). Produces an immutable docs/architecture/ADR-[NNN]-[title].md capturing the context, options considered, decision made, and consequences. Use when making any significant technical decision about architecture, technology choice, or design pattern.
wiki-page-writer
microsoft
Generates rich technical documentation pages with dark-mode Mermaid diagrams, source code citations, and first-principles depth. Use when writing documentation, generating wiki pages, creating technical deep-dives, or documenting specific components or systems.
business-knowledge-workflow
TencentBlueKing
业务知识获取与 Skill 文档编写工作流。当用户需要熟悉新业务模块、从 iWiki 获取文档、结合代码分析生成架构文档、或将业务知识沉淀为 Skill 时使用。
c4-container
sickn33
Expert C4 Container-level documentation specialist. Synthesizes Component-level documentation into Container-level architecture, mapping components to deployment units, documenting container interfaces as APIs, and creating container diagrams. Use when synthesizing components into deployment containers and documenting system deployment architecture.
architecture-blueprint
jayeshthadani19
Comprehensive project architecture blueprint generator. Use when: generate architecture docs, create architectural blueprint, analyze codebase architecture, document tech stack, create Mermaid diagrams, map component dependencies, document API surface, detect architectural patterns, reverse-engineer
arc42-documentation
MikBin
arc42 architecture documentation template and guidance