Skip to content

About

Agent skill: turn a codebase into an interactive isometric architecture map (single HTML, file:line citations)

Resources

Stars

5 stars

Watchers

0 watching

Forks

Latest commit

 

History

5 Commits

Folders and files

Repository files navigation

codebase-atlas

skills.sh

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/

rocm-cli atlas, isometric city view

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.

Install

npx skills add mikeroysoft/codebase-atlas

Non-interactive, global, for one agent:

npx skills add mikeroysoft/codebase-atlas -g -a claude-code -y

The 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.

Use

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.

Layout

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.

License

MIT

About

Agent skill: turn a codebase into an interactive isometric architecture map (single HTML, file:line citations)

Resources

Stars

5 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages