architecture

Generate Mermaid architecture diagrams and detect codebase issues.

115|13|Updated Mar 24, 2026
One-click install
npx skills add https://github.com/Houseofmvps/ultraship --skill architecture-houseofmvps
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture
Source: https://github.com/Houseofmvps/ultraship/tree/main/skills/architecture
Command: npx skills add https://github.com/Houseofmvps/ultraship --skill architecture-houseofmvps

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Manually maintained architecture diagrams quickly drift from actual code, leading to misinformation, poor onboarding, and bad engineering decisions.

Core Features & Use Cases

  • Multi-format Diagram Generation: Auto-generates Mermaid diagrams for system architecture, API route maps, database ER diagrams, and data flow sequences directly from live project code.
  • Architectural Issue Detection: Identifies circular dependencies, orphan modules, missing middleware, and scalability bottlenecks in the codebase.
  • Use Case: When onboarding a new developer to a large legacy codebase, use this skill to instantly generate an accurate, up-to-date map of all system components and their relationships without relying on outdated internal documentation.

Quick Start

Use the architecture skill to generate a complete set of up-to-date architecture diagrams and structural analysis for the current project.

Frequently Asked Questions about architecture

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

FAQPage Schema
How do I generate architecture diagrams from code automatically?

You can generate architecture diagrams by scanning project code to produce Mermaid-based visualizations of system components, API endpoints, database schemas, and data flows. This creates self-contained documentation renderable directly in GitHub.

How do I detect circular dependencies and orphan modules in my codebase?

Detect circular dependencies and orphan modules by applying architectural issue detection to your project code. The analysis scans the codebase structure to identify missing middleware, scalability bottlenecks, and isolated modules.

Can I auto-generate database ER diagrams and API route maps from live code?

Yes, you can auto-generate database ER diagrams and API route maps directly from live project code. The tool scans your codebase to produce multi-format Mermaid diagrams reflecting actual system architecture.

What is the best way to keep architecture documentation up to date for onboarding?

The best way to maintain architecture documentation is to auto-generate live codebase architecture diagrams. This replaces manually maintained diagrams that drift from actual code, ensuring accurate onboarding for new developers.

Does this approach work for visualizing data flow sequences in a legacy codebase?

Yes, this approach works for legacy codebases by scanning project code to generate data flow sequence diagrams. It provides an accurate, up-to-date map of system components without relying on outdated internal documentation.

Are there limitations to using Mermaid diagrams for codebase analysis?

Using Mermaid diagrams for codebase analysis limits output to Mermaid-supported formats, rendering as self-contained documentation in GitHub. It focuses on structural visualization rather than runtime performance profiling.