An agent skill that turns a repository into an interactive isometric architecture map: one self-contained HTML file, no build step, no dependencies, no network requests.
Live demo: https://mikeroysoft.github.io/codebase-atlas/
Blocks are real subsystems sized by line count; roads are control/data paths that exist in the
code, each cited to a file:line on GitHub. Three switchable styles (isometric city, flat map,
deep space), animated payload dots, hover-isolation, a zoom/pan camera, and a click-to-inspect
panel.
The demo is skills/codebase-atlas/references/atlas-template.html
— the finished ROCm/rocm-cli atlas, which the skill reuses
as its rendering engine.
npx skills add mikeroysoft/codebase-atlasNon-interactive, global, for one agent:
npx skills add mikeroysoft/codebase-atlas -g -a claude-code -yThe skills CLI targets 70+ agents (Claude Code, Codex, Cursor, OpenCode, Gemini CLI, Copilot, …). For anything it doesn't cover, copy the skill directory by hand:
git clone https://github.com/mikeroysoft/codebase-atlas
cp -r codebase-atlas/skills/codebase-atlas ~/.omp/agent/skills/ # or ~/.claude/skills/, etc.The skill needs a subagent for the repo inventory and npx playwright for headless verification.
Say any of:
- "make a codebase atlas"
- "turn this repo into a visual diagram"
- "isometric codebase map"
- "visual map of the architecture"
or point at an isometric codebase screenshot and ask for the same. The agent inventories the repo, swaps the data blocks in the template, verifies screenshots headlessly, scrubs anything that describes live infrastructure, and publishes the result as an artifact.
skills/codebase-atlas/
SKILL.md the skill
references/atlas-template.html engine + rocm-cli demo data
references/atlas-template-notes.md where the data/engine seam is
index.html GitHub Pages site (embeds the demo)
See atlas-template-notes.md to
reuse the engine outside the skill.
MIT
