codebase-mapping
Repository structure and dependency analysis for understanding a codebase's architecture. Use when needing to (1) generate a file tree or structure map, (2) analyze import/dependency graphs, (3) identify entry points and module boundaries, (4) understand the overall layout of an unfamiliar codebase, or (5) prepare for deeper architectural analysis.
npx skills add majiayu000/claude-skill-registry --skill codebase-mapping-aiskillstore-marketplace --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.
# Codebase Mapping Maps repository structure and dependencies to enable targeted architectural analysis. ## Quick Start Generate a structural map: ```bash python scripts/map_codebase.py /path/to/repo --output structure.json ``` ## Process 1. **Clone or access** the target repository 2. **Generate file tree** excluding noise (node_modules, __pycache__, .git, etc.) 3. **Parse imports** to build dependency graph 4. **Identify entry points** (main.py, index.ts, setup.py, pyproject.toml) 5. **Detect boundaries** - package structure and public APIs ## Output Artifacts The skill produces: - `file_tree.txt` - Annotated directory structure - `dependencies.json` - Import graph in adjacency list format - `entry_points.md` - Identified entry points with descriptions - `module_map.md` - Package boundaries and public interfaces ## Key Patterns to Identify ### Entry Point Detection Look for these patterns: - Python: `if __name__ == "__main__"`, `setup.py`, `pyproject.toml` - Node: `package.json` main/bin fields, `index.js` - Frameworks: `app.py` (Flask), `manage.py` (Django), `main.ts` (Nest) ### Dependency Classification Classify imports as: - **External**: Third-party packages (from package man
- Quick Start
- Process
- Output Artifacts
- Key Patterns to Identify
- Entry Point Detection
- Dependency Classification
- Noise Exclusion
- Integration with Other Skills
- Example Output
python scripts/map_codebase.py /path/to/repo --output structure.json
What does the codebase-mapping skill do?
Repository structure and dependency analysis for understanding a codebase's architecture. Use when needing to (1) generate a file tree or structure map, (2) analyze import/dependency graphs, (3) identify entry points and module boundaries, (4) understand the overall layout of an unfamiliar codebase, or (5) prepare for deeper architectural analysis.
How do I install it?
Run `npx skills add majiayu000/claude-skill-registry --skill codebase-mapping-aiskillstore-marketplace --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.