Skip to content

nando65/orathon-second-brain / .agents/skills/knowledge-map

knowledge-map

Unverified

Configure, 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.md
  • apps/knowledge-map/README.md
  • apps/knowledge-map/map.config.json
  • apps/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:

  1. What should the map be called?
  2. 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.

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: 196kUpdated Claude CodeCodexVerifiedInstall
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: 192kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 192kUpdated Claude CodeCodexVerifiedInstall
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: 192kUpdated Claude CodeCodexVerifiedInstall