Force-graph explorer for the 371-skill, 75-agent, 22-team agent-almanac platform. Nodes are skills, agents, and teams; edges express domain membership and cross-references. Each node renders a domain-colored WebP pictogram produced by an R/ggplot2 icon pipeline. Built with force-graph, 9 color themes, and 5 locales.
cd viz
npm install
npm run dev # starts Vite dev serverThe dev server runs at http://localhost:5173. For a production build:
npm run build # outputs to viz/dist/
npm run preview # serves dist/ locallyThe data and icon pipeline is separate from the Vite frontend build. Run it whenever registry content changes:
npm run pipeline # runs build.sh — the single entry pointbuild.sh executes five steps in order (do not run these individually — build.sh handles platform detection and R binary selection):
| Step | Command (run by build.sh) | What it does |
|---|---|---|
| 1 | $RSCRIPT generate-palette-colors.R |
Generates palette JSON and JS color data |
| 2 | node build-data.js |
Reads all registries, writes public/data/skills.json |
| 3 | node build-icon-manifest.js |
Produces icon manifests for skills, agents, and teams |
| 4 | $RSCRIPT build-all-icons.R |
Renders standard and HD WebP icons |
| 5 | node build-terminal-glyphs.js |
Generates CLI glyph data from agent icons |
Node stages can be run separately (they don't need platform detection):
npm run build-data # step 2 only
npm run build-manifest # step 3 only
npm run build-favicon # regenerate favicon assetsdocker compose up --build
# Open http://localhost:8080config.yml holds platform-specific settings (R path, parallel strategy). Four profiles: default, wsl, windows, docker. Set R_CONFIG_ACTIVE=wsl to use a non-default profile.
audit-icon-pipeline— verify icon coverage and detect missing glyphscreate-glyph— author a new glyph for a skill, agent, or team iconenhance-glyph— improve an existing glyph's visual qualityrender-icon-pipeline— run the full pipeline end-to-end
- Root README — project overview
- Understanding the System — how skills, agents, and teams compose
- Setting Up Your Environment — R, Node.js, and WSL2 setup