mikeroysoft/codebase-atlas · agent skill · MIT

Codebase Atlas // your repo as an isometric city

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

Live demo — ROCm/rocm-cli

19 components · 23 paths · 3 styles · generated from source at main @ 0063ef1
drag to pan · wheel to zoom · hover a road to isolate it · click a building to inspect · switch style top-right open full page

What you get

Real numbers only

Block heights, district sizes, and headline stats come from a scan of the repo at a pinned commit. Nothing is estimated by the model.

file:line citations

Every component and every path links to the source that implements it, on GitHub at the scanned SHA. The map is checkable, not decorative.

Three styles, one file

Isometric city, flat map, and deep space share the same data. Rotate and tilt the camera, zoom, pan, hover-isolate, click to inspect.

Share-safe by default

A final pass scrubs live-infrastructure details: endpoints, queue names, key formats, credential locations. Structure stays; secrets do not.

How it works

  1. Inventory

    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.

  2. Build

    The agent keeps the rendering engine and swaps only the data blocks: categories, components, districts, paths. Layout rules keep the eye on the core.

  3. Verify

    Headless Playwright screenshots of all three styles and a rotated view catch label collisions, orphaned blocks, and paths cutting across districts.

  4. Scrub and publish

    Infrastructure specifics are removed, then the atlas is published as an artifact you can open, embed, or hand to someone outside the team.

Works with

Claude CodeCodexCursorOpenCode Gemini CLIGitHub CopilotWindsurfCline AmpGoosePi+ 60 more via the skills CLI

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.