An agent skill that turns any repository into an interactive architecture map. Every building is a real subsystem sized by its line count; every road is a control or data path that exists in the code, cited to the file and line that implements it. One self-contained HTML file. No build, no dependencies, no network.
$ npx skills add mikeroysoft/codebase-atlas
Block heights, district sizes, and headline stats come from a scan of the repo at a pinned commit. Nothing is estimated by the model.
Every component and every path links to the source that implements it, on GitHub at the scanned SHA. The map is checkable, not decorative.
Isometric city, flat map, and deep space share the same data. Rotate and tilt the camera, zoom, pan, hover-isolate, click to inspect.
A final pass scrubs live-infrastructure details: endpoints, queue names, key formats, credential locations. Structure stays; secrets do not.
A read-only subagent maps 15–35 subsystems: what each does, what it talks to, how big it is. Deployed services are kept distinct from code-level roles.
The agent keeps the rendering engine and swaps only the data blocks: categories, components, districts, paths. Layout rules keep the eye on the core.
Headless Playwright screenshots of all three styles and a rotated view catch label collisions, orphaned blocks, and paths cutting across districts.
Infrastructure specifics are removed, then the atlas is published as an artifact you can open, embed, or hand to someone outside the team.
Say make a codebase atlas in any agent that reads SKILL.md.
Manual install: clone the repo and copy skills/codebase-atlas into your agent's skills directory.