mapping-codebases
Generate navigable code maps for unfamiliar codebases. Extracts exports/imports via AST (tree-sitter) to create _MAP.md files per directory showing classes, functions, methods with signatures and line numbers. Use when exploring repositories, understanding project structure, analyzing unfamiliar code, or before modifications. Triggers on "map this codebase", "explore repo", "understand structure", "what does this project contain", or when starting work on an unfamiliar repository.
npx skills add majiayu000/claude-skill-registry --skill mapping-codebases-oaustegard-claude-skills-3 --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Mapping Codebases Generate `_MAP.md` files providing hierarchical code structure views. Maps show function signatures, class methods, imports, and line numbers—enabling API understanding without reading full source files. ## Installation ```bash uv venv /home/claude/.venv uv pip install tree-sitter-language-pack --python /home/claude/.venv/bin/python ``` **Bundled parsers**: The skill includes pre-built parsers for all 10 supported languages (Python, JavaScript, TypeScript, TSX, Go, Rust, Ruby, Java, HTML, Markdown) in `parsers/`. These are used automatically when the tree-sitter-language-pack runtime download fails (e.g., in proxied environments). No network access needed for supported languages. ## Generate Maps ```bash /home/claude/.venv/bin/python /mnt/skills/user/mapping-codebases/scripts/codemap.py /path/to/repo --skip tests,.github,locale ``` Common skip patterns: `tests,.github,.husky,locale,migrations,__snapshots__,coverage,target,docs` ## Navigate Via Maps After generating maps, use them for navigation—read `_MAP.md` files, not source files directly. **Workflow:** 1. Read root `_MAP.md` for high-level structure 2. Follow subdirectory links to drill into relevant areas 3
- Installation
- Generate Maps
- Navigate Via Maps
- Map Contents
- Commands
- Supported Languages
- Limitations
uv venv /home/claude/.venv uv pip install tree-sitter-language-pack --python /home/claude/.venv/bin/python Generate maps Skip directories Clean maps Dry run Verbose (debug output)
What does the mapping-codebases skill do?
Generate navigable code maps for unfamiliar codebases. Extracts exports/imports via AST (tree-sitter) to create _MAP.md files per directory showing classes, functions, methods with signatures and line numbers. Use when exploring repositories, understanding project structure, analyzing unfamiliar code, or before modifications. Triggers on "map this codebase", "explore repo", "understand structure", "what does this project contain", or when starting work on an unfamiliar repository.
How do I install it?
Run `npx skills add majiayu000/claude-skill-registry --skill mapping-codebases-oaustegard-claude-skills-3 --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From majiayu000/claude-skill-registry, a repository with 534 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.