Does this skill support visual diagrams?

Yes, the Architecture Documenter uses Mermaid syntax to create readable, maintainable diagrams for system overviews, data flows, and infrastructure layouts.

How does it ensure documentation is accurate?

The skill follows a 'tool-based inspection first' rule, using MCP tools and file analysis to verify the actual state of the project before writing any documentation.

Where are the documentation files stored?

All generated documentation is standardized within the docs/architecture/ directory, starting with a mandatory index.md file.

Can I customize the documentation templates?

Yes, while the skill provides templates for cloud, services, and CI/CD, it is designed to adapt or skip sections to fit the specific complexity of your project.

Architecture Documenter

Name: Architecture Documenter
Author: timbuchinger

bytimbuchinger

Content Management

Automates the creation and maintenance of comprehensive system architecture documentation and Mermaid diagrams.

About

The Architecture Documenter skill enables Claude to maintain accurate, reality-based documentation of your project's structure, infrastructure, and workflows within the docs/architecture/ directory. By prioritizing tool-based introspection over assumptions, it ensures your technical documentation—including a mandatory index and optional deep-dives into cloud, services, or CI/CD layouts—always reflects the current state of the codebase. It automatically generates Mermaid diagrams for visual clarity and keeps your root README in sync, making it an essential tool for maintaining technical transparency and reducing onboarding friction.

Key Features

0 GitHub stars
Context-aware creation of specialized docs for cloud topology, CI/CD, and service architecture.
Built-in support for Mermaid diagrams to visualize complex data flows and components.
Tool-based system introspection to ensure documentation matches actual code and config.
Automatic generation of a mandatory architecture index file as a central entry point.
Automatic README synchronization to link high-level overviews to detailed architecture pages.

Use Cases

Onboarding new developers by providing an instantly updated high-level system overview and visual map.
Visualizing complex microservice interactions or cloud infrastructure deployment models.
Maintaining an evergreen technical specification that evolves automatically alongside the codebase.

About

Key Features

0 GitHub stars
Context-aware creation of specialized docs for cloud topology, CI/CD, and service architecture.
Built-in support for Mermaid diagrams to visualize complex data flows and components.
Tool-based system introspection to ensure documentation matches actual code and config.
Automatic generation of a mandatory architecture index file as a central entry point.
Automatic README synchronization to link high-level overviews to detailed architecture pages.

Use Cases

Onboarding new developers by providing an instantly updated high-level system overview and visual map.
Visualizing complex microservice interactions or cloud infrastructure deployment models.
Maintaining an evergreen technical specification that evolves automatically alongside the codebase.