Agent skill · nousresearch
system-atlas
Build explorable isometric architecture atlases as HTML.
What it needs
About 6k tokens when loaded.
What this skill does
System Atlas Skill An atlas is one data file (data.mjs) that renders two views: an interactive isometric map (a single self-contained atlas.html — hover to read, click to pin, go inside for steps, moving data packets you can inspect, chapters that reveal the system a few structures at a time), and a generated text twin (SYSTEM.md) with the decisions table, every structure, the flows, and the open questions by ID. The data file is the only thing anyone edits; both views rebuild from it. It sits beside a hand-written glossary (CONTEXT.md) and ADRs. Does: interactive architecture maps with progressive disclosure, question tracking across feedback rounds, a generated text twin, and a repeatable update loop. Doesn't: static one-off diagrams (use the architecture-diagram or excalidraw skill), finished systems that only need a README, or a single diagram for a PR. When to Use Use whenever someone wants to discuss, design, review, or explain an architecture visually — "make an atlas", "map the system", "make the architecture explorable", "visualize the codebase/agent/pipeline so we can talk about it", "a diagram I can click around", "walk me through how it fits together" — or when an architecture discussion is producing a pile of open questions that need tracking across feedback rounds. Also use it to update an existing atlas after decisions change. Best when the system is new enough that vocabulary, decisions, and questions are still moving and there will be more than one feedback round. Prerequisites Node.js (any recent version; the build uses only node:fs, node:path, node:url — no npm install needed). A static server for verification (npx serve or python3 -m http.server). How to Run Every field of the data file is documented in assets/data.example.mjs. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills nousresearch/system-atlas