| name | zot-vault-wiki |
| description | Orchestrate multi-step zot vault maintenance as a compiled wiki. Use when a task spans two or more operations across `kb/raw`, `kb/wiki`, and `kb/meta`: promoting sources into durable notes, restructuring maps and concept notes, answering grounded questions from the vault, running lint passes, or resolving feedback notes. |
zot Vault Wiki
Use this skill for multi-step vault maintenance and routing. For a narrow retrieval-only task, prefer zot-vault-search. For a simple one-source capture, prefer zot-vault-ingest. For periodic cleanup without new material, zot-vault-review may be enough.
Quick Routing
zot-vault-search: find the right notes, then stop.zot-vault-ingest: absorb one source or one small coherent batch.zot-vault-review: periodic hygiene, retrospective, and backlog cleanup.zot-vault-wiki: anything that combines two or more of search, ingest, query promotion, compile, lint, or feedback resolution.
Start
- Resolve the vault path from
ZOT_VAULT, then legacy OMEGA_VAULT.
- Read the vault's
AGENTS.md, then kb/meta/index.md, kb/meta/log.md, and kb/meta/review.md.
- Read
skill-config.json when you need exact paths, operation names, or feedback conventions.
- Write in the user's working language unless they ask otherwise.
- Keep
kb/raw/** immutable. Durable synthesis belongs in kb/wiki/**.
Operation Routing
compile: restructure durable notes, split oversized pages, repair maps, strengthen links. Read references/compile.md.ingest: turn new raw material into durable wiki notes and drills. Read references/ingest.md.query: answer from the vault, then promote durable answers back into kb/wiki/** when warranted. Read references/query.md.lint: run the mechanical pass, fix structure, then verify the workflow if needed. Read references/lint.md.feedback: resolve correction notes under kb/human/feedback/open/**. Read references/feedback.md.
Read only the specific reference for the operation you are executing, plus references/schema.md when you need the vault layout or naming rules.
Shared Guardrails
- Update
kb/meta/index.md when a new durable note appears or navigation changes materially.
- Append a log entry to
kb/meta/log.md, preferably with "$ZOT_VAULT/scripts/kb-log".
- After meaningful ingest or synthesis, leave an artifact under
kb/human/active-output/** unless the user explicitly declines.
- If new note files were created and
qmd is available, refresh the vault-local collection with qmd update -c "$ZOT_QMD_COLLECTION" or the value from kb/meta/tooling.env.
- If open feedback notes exist, prefer resolving them before large restructures so you do not preserve known errors.
- This skill is for compiled knowledge work, not general journaling or scratch-note cleanup.
Notes
- The feedback flow is intentionally Obsidian-friendly and plugin-friendly, but this skill does not assume a web viewer.
- Prefer a few connected notes over one giant page.
- Preserve the user's prose in
kb/human/** unless they explicitly ask you to rewrite it.
- If you can complete the request cleanly with
search, ingest, or review alone, do that instead of using this skill by default.
