Skip to content

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

knowledge-map

Verified

Configure, build, and run the local 3D knowledge map for Markdown and text sources.

FileKindSize
SKILL.mdskill md2.3 KB
---
name: knowledge-map
description: Configure, build, and run the local 3D knowledge map for Markdown and text sources.
argument-hint: "[map title or source categories]"
---

# 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:

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