c4-architecture-c4-architecture

Document repository architecture with C4 model diagrams and OpenAPI specs.

6|Updated Mar 1, 2026
One-click install
npx skills add https://github.com/ChrstprJohn/SamsonDentalCenter --skill c4-architecture-c4-architecture-chrstprjohn
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: c4-architecture-c4-architecture
Source: https://github.com/ChrstprJohn/SamsonDentalCenter/tree/main/.agent/skills/SystemArchitecture/c4-architecture-c4-architecture
Command: npx skills add https://github.com/ChrstprJohn/SamsonDentalCenter --skill c4-architecture-c4-architecture-chrstprjohn

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Generate comprehensive C4 architecture documentation for an existing repository/codebase using a bottom-up analysis approach.

Core Features & Use Cases

  • Bottom-up, code-level discovery of all subdirectories to ensure complete coverage.
  • Synthesize findings into Code, Component, Container, and Context diagrams following the official C4 model.
  • Automatically produce and organize documentation under C4-Documentation/, including API specs where applicable.
  • Support for optional resources (scripts, references, assets) to enrich the documentation.

Quick Start

Run the skill against your repository to generate end-to-end C4 documentation.

Frequently Asked Questions about c4-architecture-c4-architecture

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate C4 architecture documentation for an existing codebase?

To generate C4 architecture documentation, this skill analyzes all repository subdirectories using a bottom-up approach to produce code, component, container, and context diagrams, saving outputs under a dedicated documentation directory.

What is a bottom-up approach to system design documentation?

A bottom-up approach to system design documentation starts by analyzing individual code-level subdirectories to discover components, then synthesizes findings upward into container and context diagrams following the official C4 model.

Can I automatically create OpenAPI specs from my repository's architecture?

Yes, you can automatically create OpenAPI specs from your repository's architecture. The skill identifies container APIs during analysis and includes the corresponding OpenAPI specifications within the generated C4 documentation outputs.

Does this C4 model documentation tool work with repositories that have no dependencies?

Yes, this C4 model documentation tool works with repositories that have no dependencies. It requires no external components or prerequisites, directly analyzing your existing codebase structure to automate the architecture documentation process.

What's the best way to document system architecture across multiple subdirectories?

The best way to document system architecture across multiple subdirectories is using automated bottom-up code analysis. This ensures complete coverage of your codebase and synthesizes findings into structured C4 context, container, and component diagrams.

When do I need architecture documentation automation for my code repository?

You need architecture documentation automation when you want to systematically map an existing codebase into C4 diagrams. It eliminates manual diagramming by discovering code-level structures and organizing them into a comprehensive documentation directory.