# Vault Search

> Search the vault for notes matching a natural language query. Triggers: "find notes about", "search vault", "which notes mention", "do I have anything on", "look up", "where did I write about", "what do I know about X?".

- Skill: `seangsisg/vault-search` (Agent Skill)
- Install (CLI): `npx skillmds@latest add seangsisg/vault-search`
- Raw SKILL.md: https://api.skillmd.com/api/skills/seangsisg/vault-search/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: seanGSISG (https://skillmd.com/u/seangsisg)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/seangsisg/vault-search

---


# Vault Search

Find notes across `Notes/*/` subfolders that match a natural language query.

## Approach

Interpret the query and search across multiple dimensions:

- **Type match**: If the query implies a note type (e.g., "guides about X"), grep frontmatter for type matches
- **Tag match**: If the query maps to a known tag, grep frontmatter — highest-confidence results
- **Title match**: Search filenames across all `Notes/*/` subfolders
- **Content match**: Grep note bodies for keywords

Notes matching multiple dimensions rank higher than single-dimension matches.

## Presenting results

Show top results in a table: note name (as `[[wikilink]]`), type, tags, match reason. Cap at ~15 for broad queries. If nothing matched, suggest alternative terms or tags.

Relevance over completeness.