milad-ahmd/codebase-explainer

> This skill lives in the main collection: milad-ahmd/agent-skills. Please ⭐ star it there; that's where updates land first.
> Docs: https://milad-ahmd.github.io/agent-skills/skills/codebase-explainer/ · Claude Code: /plugin install all-skills --marketplace milad-ahmd/agent-skills
# 🗺️ codebase-explainer
Onboarding guide built from a real import graph: entry points, hubs, cycles, Mermaid and an interactive map. An Agent Skill for Claude Code, Cline, Cursor, Codex and other AI coding agents.
Install · Usage · How it works · All skills
> Part of agent-skills, a growing collection of practical skills for AI coding agents.
## 📦 Install
One command (installs the whole collection):
bash
curl -fsSL https://raw.githubusercontent.com/milad-ahmd/agent-skills/main/install.sh | bash -s -- codebase-explainer
Manually (Claude Code):
bash
git clone https://github.com/milad-ahmd/codebase-explainer /tmp/codebase-explainer
mkdir -p ~/.claude/skills && cp -r /tmp/codebase-explainer/skills/codebase-explainer ~/.claude/skills/
Per project: copy skills/codebase-explainer into /.claude/skills/.
Any other agent: paste SKILL.md into your rules or system prompt.
## 💬 Usage
Just ask your agent:
text
Explain this codebase
Map how the modules in this repo depend on each other
The full workflow, rules and output format are in SKILL.md.
## 🔎 Sample output
codemap.py is plain Python 3 with no dependencies. Real output on the small Python fixture that ships with it:
text
$ python3 codemap.py fixtures/pyapp
Code map of pyapp: 11 files, 41 LOC (python 11)
4 modules at depth 2, 12 internal file edges, 3 module edges, 1 external packages
Modules (by LOC)
module files LOC fan-in fan-out ext
mypkg 6 27 3 0 1
. 2 5 0 1 0
tests 1 5 0 1 0
mypkg/sub 2 4 0 1 0
Entry points (2)
main.py [main guard, file name]
mypkg/cli.py [file name, pyproject.toml script]
Hubs: most imported files, change with care (1)
mypkg/core.py imported by 7 files (+1 tests), 6 LOC, in a cycle
Import cycles: 2 between files, 0 between modules
[import-time] mypkg/core.py -> mypkg/utils.py -> mypkg/core.py
[lazy only] mypkg/lazy.py -> mypkg/models.py -> mypkg/lazy.py
Orphans: not imported and not an entry point (2)
mypkg/sub/deep.py
orphan.py
External packages (top 1 of 1)
requests 1 file(s) (python)
Not visible to this static parse: imports built from strings at runtime, DI containers, reflection, plugin loading, framework conventions (routes, decorators) and calls between services over HTTP.