codemap

Generate CODEMAP.md and ARCHITECTURE.md navigation maps for codebases.

11|2|Updated Oct 1, 2025
One-click install
npx skills add https://github.com/antoniocascais/claude-code-toolkit --skill codemap-antoniocascais
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: codemap
Source: https://github.com/antoniocascais/claude-code-toolkit/tree/main/skills/codemap
Command: npx skills add https://github.com/antoniocascais/claude-code-toolkit --skill codemap-antoniocascais

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill generates CODEMAP.md navigation maps to help developers and AI agents understand a codebase.

Core Features & Use Cases

  • Codebase mapping: Produce a structured map detailing technology, structure, and entry points to aid onboarding and code exploration.
  • Architecture diagrams: Create architecture references illustrating component relationships and infra layout.
  • Use Case: When starting a new project, run codemap to generate CODEMAP.md and ARCHITECTURE.md to guide the team.

Quick Start

Run the codemap skill on your repository to produce CODEMAP.md and ARCHITECTURE.md with a proposed codebase map.

Frequently Asked Questions about codemap

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

FAQPage Schema
How do I generate a codebase navigation map for onboarding?

Codebase navigation maps help developers and AI agents understand a repository by producing a structured map with the tech stack, directory structure, entry points, and architecture diagrams, outputting both CODEMAP.md and ARCHITECTURE.md files.

Can I generate architecture diagrams for a monorepo?

Yes, codemap supports monorepos by analyzing project size and detecting infrastructure patterns to output a structured map illustrating component relationships and infrastructure layout in ARCHITECTURE.md.

Does codebase mapping exclude vendored code during analysis?

Yes, codemap excludes vendored code during analysis to ensure the generated CODEMAP.md and ARCHITECTURE.md accurately reflect your repository's own code and infrastructure patterns.

What is the best way to document repository entry points and directory structure?

Run codemap to generate a structured CODEMAP.md detailing the tech stack, directory structure, and entry points, providing a navigational map that aids onboarding and code exploration for your team.

How to create architecture references illustrating component relationships?

Run codemap on your repository to detect infrastructure patterns and output ARCHITECTURE.md with architecture diagrams illustrating component relationships and infrastructure layout.