nando65/orathon-second-brain / .claude/skills/knowledge-map
knowledge-map
UnverifiedConfigure, build, and run the local 3D knowledge map for Markdown and text sources.
Knowledge Map
This skill builds an independent local 3D explorer with drag-to-orbit, zoom, auto-rotation, and a cinema view. It does not require external services or API keys.
Read:
SYSTEM.mdapps/knowledge-map/README.mdapps/knowledge-map/map.config.jsonapps/knowledge-map/map.config.local.json, if present (takes precedence over shared defaults)
Configure
Reuse the existing title and verified source paths when available. A bare invocation rebuilds and opens the current map; it does not reset configuration.
Ask only for information not already supplied:
- What should the map be called?
- Which local categories should it include?
For each category, record:
- an ID,
- display label,
- one or more verified local paths.
Use 1–10 categories. Do not guess paths.
Update apps/knowledge-map/map.config.local.json so user-specific paths remain untracked.
Build and run
From repository root:
node scripts/build-map.mjs
node scripts/serve-map.mjs
The server binds only to 127.0.0.1. Use the configured port (default 4747). If that address already serves this map, reuse it instead of launching a duplicate server.
Open the local URL when browser access is available; otherwise provide the link. Explain that dragging orbits the globe, scrolling zooms, and clicking a sphere reads a note. The app README documents keyboard and touch controls.
Verify
Confirm:
- the generated node count is nonzero when selected sources contain notes,
- configured categories appear,
- dragging changes the viewing angle, zoom works, and auto-rotation can be started and paused,
- cinema mode can be entered and exited,
- search finds a known note,
- category filtering works,
- selecting a node opens its note content; Browse notes also provides keyboard-accessible selection,
- explicit Markdown links are rendered when their target can be resolved,
- no source files were modified.
Only indexed files and resolved explicit links count as knowledge. Curved globe/orbit guides are decorative.
If a category is empty, report it honestly. Do not invent knowledge to populate the map.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 192k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 192k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 192k | Updated | Claude CodeCodex | Verified | Install |