vault-search

Search Obsidian vault content and open the top wikilink-connected match.

Updated Feb 28, 2026
One-click install
npx skills add https://github.com/cosmicdreams/claude-plugins --skill vault-search-cosmicdreams
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: vault-search
Source: https://github.com/cosmicdreams/claude-plugins/tree/main/lib/skills/vault-search
Command: npx skills add https://github.com/cosmicdreams/claude-plugins --skill vault-search-cosmicdreams

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates the time-consuming task of manually searching your Obsidian vault by letting you search note content and immediately see the connected neighborhood around each match.

Core Features & Use Cases

  • Graph-aware vault search: Finds matching notes by content, then follows one hop of wikilinks to surface related context.
  • Targeted, read-only behavior: Never modifies vault files and filters out excluded directories like .obsidian/, Archive/, and Scratches/.
  • Result prioritization: Ranks matches by hit count and link connectivity, then opens the top result in Obsidian.

Quick Start

Ask the Skill to search your vault for a topic and return the best matching note plus its one-hop linked neighborhood.

Frequently Asked Questions about vault-search

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search for text inside Obsidian notes and see connected wikilinks?

To search Obsidian notes and see connected wikilinks, this Skill performs a read-only Grep across Markdown files to match query text, then extracts one-hop wikilink neighbors to display surrounding context around the strongest hits.

Can I look up a specific note in my vault without browsing directories?

Yes, you can look up a note without browsing directories by providing a query, which triggers a content search that ranks matches by hit count and link connectivity, then opens exactly the top result via an obsidian:// URI.

Does this vault search method modify or delete my existing Markdown files?

No, this vault search method is strictly read-only and never modifies your files. It specifically filters out excluded directories like `.obsidian/`, `Archive/`, and `Scratches/` during the search process.

What is the best way to find related notes for a research question in Obsidian?

The best way to find related notes for a research question is using graph-aware search, which matches content and follows one hop of wikilinks to surface and rank connected context, eliminating manual directory browsing.

Why does my vault search only show one note instead of a list of files?

Your vault search only shows one note because the Skill prioritizes results by hit count and link connectivity, resolving Glob targets to open exactly the top match in Obsidian rather than listing all files.