architecture

Generate architecture documentation with Mermaid diagrams for codebases.

Updated Jun 22, 2026
One-click install
npx skills add https://github.com/skylarsabo/code-ops --skill architecture-skylarsabo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture
Source: https://github.com/skylarsabo/code-ops/tree/main/plugins/code-ops-suite/skills/architecture
Command: npx skills add https://github.com/skylarsabo/code-ops --skill architecture-skylarsabo

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides a deep, diagram-rich architecture reference for a codebase, eliminating the need for a separate architecture document.

Core Features & Use Cases

  • Comprehensive Documentation: Documents the system context, containers, components, critical flows, cross-cutting concerns, and architectural decisions.
  • Code-Grounded Diagrams: Mermaid diagrams with narrative explanations for responsibilities, boundaries, and split rationale.
  • Use Case: Use this Skill to create an architecture overview for a new codebase, ensuring that the system's structure and flows are well-documented and easily understood.

Quick Start

Use the /code-ops-suite:architecture command to initiate the documentation process for your codebase.

Frequently Asked Questions about architecture

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

FAQPage Schema
How do I generate architecture documentation for a codebase?

To generate architecture documentation, analyze your codebase to produce system context, container diagrams, component breakdowns, critical flow diagrams, and architectural decisions using Mermaid visualizations.

How do I create system context and container diagrams for a complex codebase?

Creating system context and container diagrams involves mapping the codebase structure to generate Mermaid diagrams with narrative explanations for responsibilities, boundaries, and split rationale.

Can I document architectural decisions and critical flows automatically?

Yes, documenting architectural decisions and critical flows is possible by generating code-grounded Mermaid diagrams with narrative explanations for responsibilities, boundaries, and split rationale.

Is this architecture documentation tool suitable for senior engineers?

This architecture documentation tool is designed for senior engineers working on complex systems, focusing on system understanding, structure, and flows with code-grounded diagrams.

What's the best way to visualize codebase architecture without a separate document?

The best way to visualize codebase architecture without a separate document is to generate a deep, diagram-rich architecture reference detailing system context, containers, components, and critical flows.

Are Mermaid diagrams required for codebase architecture visualization?

Yes, Mermaid diagrams are required for codebase architecture visualization to detail system context, containers, components, critical flows, and architectural decisions with narrative explanations.