Run any Skill in Manus with one click

zot-vault-search

Stars99

Forks8

UpdatedApril 10, 2026 at 00:58

Search-only skill for zot vaults. Use when you need to locate the right notes quickly before reading or answering. Prefer the vault-local `scripts/kb-search`; it uses the vault's QMD collection when available and falls back to ripgrep when QMD is not installed or fails. Not for ingest, review, large restructuring, or feedback resolution.

Installation

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

Run Skill in Manus

Source

Hurricane0698

Hurricane0698/zot

View GitHub Repository View Creator Repositories

Download

Run Skill in Manus

Related occupationsSOC

Based on SOC occupation classification

Office Clerks, GeneralOffice and Administrative Support Occupations·SOC 43-9061

SKILL.md

readonly

name	zot-vault-search
description	Search-only skill for zot vaults. Use when you need to locate the right notes quickly before reading or answering. Prefer the vault-local `scripts/kb-search`; it uses the vault's QMD collection when available and falls back to ripgrep when QMD is not installed or fails. Not for ingest, review, large restructuring, or feedback resolution.

zot Vault Search

Purpose

Search the current zot vault efficiently before reading large note sets.

Use this when the job is "find the right notes fast". If the task becomes "turn findings into durable notes", hand off to zot-vault-ingest or zot-vault-wiki.

Workflow

Resolve the vault path from ZOT_VAULT, then legacy OMEGA_VAULT, then ask the user only if neither exists.
Start with "$ZOT_VAULT/scripts/kb-search" "query".
If new files were just added, run qmd update -c "$ZOT_QMD_COLLECTION" first when QMD is installed.
If the result set is still noisy, narrow by domain folder under kb/wiki/ or kb/raw/.
Read the highest-signal notes, not everything.
Stop once you have the right reading set or a concise cited answer.

Notes

scripts/kb-search reads the vault-local collection from kb/meta/tooling.env, so multiple vaults do not silently share one global index.
If QMD is absent or fails, the script falls back to rg so the workflow never breaks.
Use scripts/kb-smoke-test when you want to verify the vault search stack end-to-end.
Do not use search as an excuse to skip synthesis; search is only the front-end to reading.
If the task now involves creating or restructuring notes, switch to zot-vault-ingest, zot-vault-review, or zot-vault-wiki instead of stretching this skill.

More from this repository

same repository

zot-vault-ingest

Hurricane0698/zot

Single-source or single-batch ingest skill for zot vaults. Use when the user asks to save, 整理, 归档, absorb, or integrate conversations, terminal findings, project brainstorming, blogs, podcasts, course material, or life observations into a zot Obsidian vault. Capture raw material under `kb/raw`, create the minimum durable notes under `kb/wiki`, update `kb/meta/log.md` and `kb/meta/index.md`, refresh QMD indexing when new files are added, and leave active-output prompts in `kb/human/active-output`. Not for review passes, broad restructures, or feedback triage.

2026-04-1099

zot-vault-review

Hurricane0698/zot

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.

2026-04-1099

zot-vault-wiki

Hurricane0698/zot

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.

2026-04-1099

qmd

Hurricane0698/zot

Search markdown knowledge bases, notes, and documentation using QMD. Use when users ask to search notes, find documents, or look up information.

2026-04-0899

name	zot-vault-search
description	Search-only skill for zot vaults. Use when you need to locate the right notes quickly before reading or answering. Prefer the vault-local `scripts/kb-search`; it uses the vault's QMD collection when available and falls back to ripgrep when QMD is not installed or fails. Not for ingest, review, large restructuring, or feedback resolution.

zot Vault Search

Purpose

Search the current zot vault efficiently before reading large note sets.

Use this when the job is "find the right notes fast". If the task becomes "turn findings into durable notes", hand off to zot-vault-ingest or zot-vault-wiki.

Workflow

Resolve the vault path from ZOT_VAULT, then legacy OMEGA_VAULT, then ask the user only if neither exists.
Start with "$ZOT_VAULT/scripts/kb-search" "query".
If new files were just added, run qmd update -c "$ZOT_QMD_COLLECTION" first when QMD is installed.
If the result set is still noisy, narrow by domain folder under kb/wiki/ or kb/raw/.
Read the highest-signal notes, not everything.
Stop once you have the right reading set or a concise cited answer.

Notes

scripts/kb-search reads the vault-local collection from kb/meta/tooling.env, so multiple vaults do not silently share one global index.
If QMD is absent or fails, the script falls back to rg so the workflow never breaks.
Use scripts/kb-smoke-test when you want to verify the vault search stack end-to-end.
Do not use search as an excuse to skip synthesis; search is only the front-end to reading.
If the task now involves creating or restructuring notes, switch to zot-vault-ingest, zot-vault-review, or zot-vault-wiki instead of stretching this skill.