vaultr-index-knowledge

Vaultr Index Knowledge

Scans the knowledge directory, finds units not yet in any index, and adds them. Running this skill repeatedly is safe and always converges — it only ever adds missing entries, never rewrites existing ones.

Domain index files live at <knowledge-dir>/_indexes/<Domain>.md. The compile skill matches a note to a domain by the index filename alone (e.g. AI.md, Business.md).

A unit may appear in at most 2 indexes: one primary domain, one secondary only when the unit genuinely straddles two.

Run all steps to completion without stopping. Only speak at the end (Step 4 summary).

---

Inputs

• Knowledge directory — default: _knowledge/ (relative to cwd, which is always the vault root)

The index directory is always <knowledge-dir>/_indexes/. Create it if it does not exist.

---

Step 1 — Find unindexed units

Scan all knowledge units:

find <knowledge-dir> -name "*.md" -not -path "*/_indexes/*" | sort

Scan all existing index files and collect every Path value from their tables:

find <index-dir> -name "*.md" | sort

A unit is unindexed if its vault-absolute path (e.g. /_knowledge/Vertical Agent.md) does not appear in any index table. Build a list of only these units.

If all units are already indexed, report and stop.

---

Step 2 — Read unindexed units

For each unindexed unit, read its YAML front matter and first non-heading paragraph. Build an internal list:

references/extract.md documents partial-read commands — vaultr extract tag retrieves front-matter tags directly; vaultr extract segment --head N retrieves the opening lines. Use them instead of a full vaultr read when only these fragments are needed.

title          | entity_type | tags          | summary (≤80 chars)                              | vault-absolute path
Vertical Agent | concept     | [ai, agent]   | AI product focused on a specific vertical domain | /_knowledge/Vertical Agent.md
Jane Smith     | person      | [founder, ai] | Founder of SophiaPro, AI startup                 | /_knowledge/Jane Smith.md