second-brain-mappinglisted

# /second-brain-mapping > **`{SKILL_DIR}`** = this skill's own folder (locally: the directory this SKILL.md lives in; a served brain substitutes the real absolute path before you read this). Shared starter files live at the repo root two levels up: `{SKILL_DIR}/../..`. If a path does not resolve, name the missing file and stop — never guess another location. Your vault is a database. This skill makes it queryable. ## What it does | Phase | Tool | LLM cost | Always runs? | |---|---|---|---| | 1 | `vault-metadata-extract.py` (dispatcher → type-specific extractors) | **0 tokens** | Yes | | 2 | `/graphify` (optional) | ~100k–1M tokens | No — asks first | | 2b | `graphify_report_sanitize.py --check` — keeps the graph report from flooding the vault's graph view | **0 tokens** | Yes, whenever a report exists | | 3 | Wikilink gaps + interactive apply | ~5k tokens | If graph exists | | 4 | `vault-insight-engine.py` — cross-type surprise finder | **0 tokens** | Yes | Phases 1, 2b and 4 are free. Phase 2 is expensive and opt-in. Phase 3 needs interactive approval so it skips gracefully in non-TTY contexts. 2b runs even when 2 is skipped — a report left by an earlier run is the thing it protects against. ## Setup Run once after cloning ai-brain-starter: ``` /setup-vault-types ``` Interactive wizard asks which doc types you have (journal, book, article, meeting, person, project, podcast, client, etc.) and installs the matching extractors. You can add custom types later by editing