Agent skill · software engineering · aiskillstore
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.
Why this skill is useful
Adds a script for generating a codebase structure map and dependency analysis that the AI wouldn't reliably generate on its own.
What it needs
Requires python installed locally. About 1k tokens when loaded. Last updated 2026-08-07. 405 stars on the source repository.
What this skill does
Codebase Mapping Maps repository structure and dependencies to enable targeted architectural analysis. Quick Start Generate a structural map: Process 1. Clone or access the target repository 2. Generate file tree excluding noise (nodemodules, 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: filetree.txt - Annotated directory structure dependencies.json - Import graph in adjacency list format entrypoints.md - Identified entry points with descriptions modulemap.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 manager) Internal: Project modules (relative imports) Standard: Language standard library Noise Exclusion Always exclude: Integration with Other Skills This skill provides the foundation for: data-substrate-analysis → Focus on types.py, models.py execution-engine-analysis → Focus on runner files control-loop-extraction → Focus on agent.py, loop files component-model-analysis → Focus on base classes Example Output
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aiskillstore/codebase-mapping