c4-architecture

Generate software architecture documentation using C4 model diagrams in Mermaid syntax.

IndexedApache-2.0

Install

Works with Claude Code, Claude apps, Codex, Cursor, Gemini CLI, GitHub Copilot, VS Code, OpenCode, Goose, Windsurf. Read the repository before you give any tool access to your data.

npx agentmarket install skill/gunesh22-c4-architecture

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

About

Generate software architecture documentation using C4 model diagrams in Mermaid syntax.

Reviews

Write a review

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this skill can do and what it asks for, from its SKILL.md. Checked Oct 25, 2026.

Tools: No tools found
Secrets: None asked for
Install scripts: None found

Network hosts it talks to 1

codeload.github.com · found in install command

Files it touches

~/.claude/skills/c4-architecture

What's inside

Skill name: c4-architecture
Description: Generate software architecture documentation using C4 model diagrams in Mermaid syntax.
License: Apache-2.0
Instructions: 54 lines in SKILL.md · view on GitHub

Files (1)

SKILL.md

SKILL.md (first lines)

# C4 Architecture Documentation
Generate software architecture documentation using C4 model diagrams in Mermaid syntax.

## Workflow
1. Understand scope - Determine which C4 level(s) are needed.
2. Analyze codebase - Identify components, containers, and relationships.
3. Generate diagrams - Create Mermaid C4 diagrams.
4. Document - Write diagrams to markdown files with context.

## C4 Diagram Levels
- **System Context (Level 1)**: Big picture. User <-> System relationships.
- **Container Diagram (Level 2)**: High-level tech choices. Deployable units (SPA, API, DB).
- **Component Diagram (Level 3)**: Internals. Controllers, Services, Repositories.
- **Dynamic Diagram**: Runtime flow (e.g., Request -> Service -> DB).

## Syntax Reference (Mermaid C4)

### People and Systems
\\\mermaid
Person(alias, "Label", "Description")
Person_Ext(alias, "Label", "Description")
System(alias, "Label", "Description")
System_Ext(alias, "Label", "Description")
SystemDb(alias, "Label", "Description")
\\\

### Containers
\\\mermaid
Container(alias, "Label", "Tech", "Description")
ContainerDb(alias, "Label", "Tech", "Description")
\\\

### Components
\\\mermaid
Component(alias, "Label", "Tech", "Description")
\\\

### Relationships
\\\mermaid
Rel(from, to, "Label", "Tech")
Rel_U(from, to, "Label")
Rel_D(from, to, "Label")
Rel_L(from, to, "Label")
Rel_R(from, to, "Label")
\\\

## Best Practices
1. **Unidirectional Arrows**: Avoid ambiguity.
2. **Action Verbs**: Label relationships (e.g., "Persists to", "Authenticates with").
3. **Tech Labels**: Include protocols/formats (e.g., "JSON/HTTPS").
4. **Limits**: Keep diagrams under 20 elements.
5. **Aliases**: Use descriptive aliases (e.g., \uthService\).

From Gunesh22/tgf-excel-version-2, Apache-2.0.

Signals

Stars: 0
Forks: 1
Open issues: 0
Last commit (this folder): Apr 28, 2026 (6 months ago)

From GitHub (fetched Oct 24, 2026).

Details

License: Apache-2.0
Repository: github.com/Gunesh22/tgf-excel-version-2
Website: tgf-excel-v2.vercel.app
First seen: Oct 24, 2026
Last checked: Oct 24, 2026
Source: GitHub github-graphql

More from Gunesh22

Cite this page

c4-architecture skill. Agent Mart. https://agentmart.dev/skills/gunesh22-c4-architecture (last updated 2026-10-24)