skills.rest
bacchus-labs
bacchus-labsOFFICIAL
Explore all skills by this author →
GitHub

map-codebase

Generate ARCHITECTURE.md with Mermaid diagrams from codebase structure and dependencies.

1|Updated Feb 11, 2026
Search Tags:#architecture#documentation#mermaid#codebase#dependencies#repository analysis
One-click install
npx skills add https://github.com/bacchus-labs/steamship-integrations --skill map-codebase-bacchus-labs
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: map-codebase
Source: https://github.com/bacchus-labs/steamship-integrations/tree/main/.wingman/playbooks/skills/map-codebase
Command: npx skills add https://github.com/bacchus-labs/steamship-integrations --skill map-codebase-bacchus-labs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill turns unfamiliar repositories into clear architectural maps, reducing the time needed to understand modules, dependencies, key types, and system flows.

Core Features & Use Cases

  • Architecture Documentation: Generates an ARCHITECTURE.md file with Mermaid diagrams that explain repository structure, dependencies, relationships, and execution flows.
  • Codebase Analysis: Examines project organization, languages, packages, imports, entry points, and important symbols to create a high-level technical overview.
  • Use Case: Use this Skill when onboarding to a new project, preparing for a refactor, or creating maintainable architecture documentation for a code review.

Quick Start

Use the map-codebase skill to create an architecture overview for this repository.

Frequently Asked Questions about map-codebase

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

FAQPage Schema
How do I generate architecture documentation for an unfamiliar codebase?▼

Architecture documentation for an unfamiliar codebase is generated by analyzing repository structure and dependencies to produce an overview with Mermaid diagrams and validated markdown output.

How does codebase visualization help with repository onboarding?▼

Codebase visualization accelerates repository onboarding by mapping modules, dependencies, key types, and system flows into clear visual diagrams, reducing the time needed to understand unfamiliar project architecture.

Can I create Mermaid diagrams automatically from my repository structure?▼

Yes, you can create Mermaid diagrams automatically by indexing important symbols and examining project organization, imports, and entry points to map the repository structure and dependency relationships.

What is the best way to prepare for a codebase refactoring?▼

The best way to prepare for codebase refactoring is to generate a high-level technical overview that maps current module relationships and execution flows, ensuring you fully understand the architecture before making changes.

Does this approach work for technical documentation workflows and architectural reviews?▼

Yes, this approach applies directly to technical documentation workflows and architectural reviews by generating an ARCHITECTURE.md file that explains repository structure, dependencies, relationships, and execution flows.

What is included in a generated codebase architecture overview?▼

A generated codebase architecture overview includes project organization, languages, packages, imports, entry points, important symbols, and Mermaid diagrams illustrating dependencies and execution flows.

Related Skills

Explore More Software Engineering Skills→
ckallumckallum

zoom-out

Map a code target's callers, collaborators, and entry points.

Community
Intermediate
royhenengelroyhenengel

architecture-diagrams

Generate system architecture diagrams, C4 models, flowcharts, and sequence diagrams using Mermaid and PlantUML.

Community
Intermediate
phanijappsphanijapps

engram-index

Index repositories and generate architectural maps with symbol and call analysis.

Community
Intermediate
oto1720oto1720
1

tech-architecture-diagram

Generate Mermaid, HTML, and SVG architecture diagrams from repository structure and dependencies.

Community
Advanced