mapping-codebases

Generate hierarchical navigation maps of codebases using tree-sitter analysis.

137|7|Updated Oct 17, 2025

Search Tags:#code analysis #code navigation #tree-sitter #codebase mapping #structure visualization #project exploration #AST parsing

Ready to run

npx skills add https://github.com/oaustegard/claude-skills --skill mapping-codebases

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: mapping-codebases
Source: https://github.com/oaustegard/claude-skills/tree/main/mapping-codebases
Command: npx skills add https://github.com/oaustegard/claude-skills --skill mapping-codebases

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires tree-sitter, tree-sitter-languages, and includes scripts (resource) components.

What problem does it solve?

This Skill eliminates the overwhelming confusion when exploring large, unfamiliar codebases by automatically generating hierarchical navigation maps.

Core Features & Use Cases

AST-Powered Analysis: Uses tree-sitter to extract exports and imports from source code without reading every file.
Hierarchical Navigation: Creates linked _MAP.md files that let you drill down into code structure naturally.
Use Case: Imagine you've just joined a new project with 500+ files. Use this Skill to generate maps that show you the high-level structure, then navigate to specific subdirectories without getting lost in the details.

Quick Start

Use the mapping-codebases skill to generate navigable code maps for the current repository. Install dependencies with uv pip install tree-sitter tree-sitter-languages, then run the codemap script to create directory maps.