zot Vault Ingest
This skill is for turning one new source, or one coherent small batch of sources, into durable vault knowledge.
Use zot-vault-wiki instead when the request spans multiple operations, such as ingest plus restructure, ingest plus query promotion, or ingest plus feedback resolution.
Required workflow
- Resolve the vault path from
ZOT_VAULT, then legacyOMEGA_VAULT. - Read the vault's
AGENTS.mdfirst when it exists. - Unless the user explicitly requests another language, write new raw captures, wiki syntheses, active-output prompts, and log-facing summaries in the user's working language.
- Keep raw material in
kb/raw/**; do not overwrite it. - Write durable synthesis to
kb/wiki/**using the templates inkb/templates/when useful. - Update
kb/meta/index.mdwhen a new durable page appears. - Append a standardized entry to
kb/meta/log.md. - Refresh retrieval with
qmd update -c <vault-local-collection>when new notes were created. - Leave an internalization artifact in
kb/human/active-output/unless the user explicitly declines. - If the ingest reveals that large existing notes need splitting or cleanup, stop the ingest cleanly and continue with
zot-vault-wiki.
Helpful commands
"$ZOT_VAULT/scripts/kb-capture" --kind conversation --title "..." --stdin"$ZOT_VAULT/scripts/kb-log" ingest "title" --raw "[[...]]" --changed "[[...]]" --output "[[...]]" --note "...""$ZOT_VAULT/scripts/kb-lint""$ZOT_VAULT/scripts/kb-smoke-test"when you want to verify the local workflow
Quality bar
- Prefer updating a few connected notes over dumping one giant summary.
- Add
## Sourcessections to durable notes. - Push the user toward active recall, application, and confusion-clearing.
- Do not touch legacy root notes unless the user asked for migration.
- Keep the scope tight. This skill should finish an ingest, not become a general maintenance pass.
Source: Hurricane0698/zot — distributed by TomeVault.