| name | zot-vault-review |
| description | Periodic review skill for zot vaults. Use when the user asks for weekly review, vault maintenance, linting, retrospective, meta-learning analysis, or to turn accumulated notes into clearer understanding and output drills. Include QMD refresh and search checks, and use the smoke test when local workflow wiring needs verification. Not for first-time ingest of new sources or large cross-operation wiki rewrites. |
zot Vault Review
This skill is for periodic maintenance and synthesis of a zot vault.
Use zot-vault-wiki instead when the review turns into a broader compile pass, a feedback-resolution sprint, or a multi-step reorganization across many notes.
Required workflow
- Resolve the vault path from
ZOT_VAULT, then legacy OMEGA_VAULT.
- Read
kb/meta/index.md, kb/meta/log.md, and kb/meta/review.md when present.
- Run
qmd update -c <vault-local-collection> if note files changed since the last review.
- Run
"$ZOT_VAULT/scripts/kb-lint" for a mechanical pass.
- Identify orphan notes, stale syntheses, duplicated concepts, and missing active-output drills.
- If the review produced durable insight, file it under
kb/wiki/syntheses/ or kb/wiki/queries/.
- Use
"$ZOT_VAULT/scripts/kb-smoke-test" when search or CLI wiring looks suspicious.
- When the user asks for versioning, review the diff before any commit.
- If the work stops being a review and becomes a structural rewrite, switch to
zot-vault-wiki.
Review outputs to prefer
- weekly synthesis note
- error-pattern note
- "teach it back" drill
- migration suggestions from legacy notes into
kb/wiki/**
- retrieval sanity check based on
CLI + qmd smoke test
Guardrails
- Do not auto-commit without checking what changed.
- Keep reviews focused on compounding understanding, not vanity metrics.
- If a file may contain secrets, flag it and recommend rotation or removal.
- Prefer review outputs such as backlog trimming, synthesis notes, and drills over broad note surgery.
