search

Search local wiki vaults with hybrid BM25/vector retrieval and grep fallback.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/RonanCodes/llm-wiki --skill search-ronancodes
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: search
Source: https://github.com/RonanCodes/llm-wiki/tree/main/.claude/skills/search
Command: npx skills add https://github.com/RonanCodes/llm-wiki --skill search-ronancodes

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Users need a reliable way to find relevant pages and passages inside a local wiki vault without re-deriving knowledge or manually scanning files, and this Skill provides ranked retrieval and sensible fallbacks.

Core Features & Use Cases

  • Hybrid ranked retrieval: Uses qmd for BM25 + vector search with LLM re-ranking to return the most relevant pages and snippets.
  • Robust fallback: Automatically falls back to recursive grep when qmd is not available, extracting matching lines and frontmatter for context.
  • Index management: Detects whether a vault is indexed, performs initial indexing or updates, and parses qmd JSON output into readable results.
  • User flows: Ideal for reading, exploring, and sourcing citations from an Obsidian-style vault, or for triaging results before deeper synthesis with a query tool.

Quick Start

Search the vault named my-research for "deployment patterns" and show the top results with snippets.

Frequently Asked Questions about search

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

FAQPage Schema
How do I search for specific text and passages inside an Obsidian vault?▼

To search an Obsidian vault, you need ranked retrieval that scans local wiki pages to locate relevant documents and matching text snippets. This Skill uses qmd for hybrid BM25 and vector search to return ranked pages with snippets.

Can I find matching text in my wiki if qmd is not installed?▼

If qmd is not installed, the search falls back to recursive grep to locate matching text. It automatically extracts matching lines and frontmatter for context, and can offer Homebrew or Cargo installation for qmd.

What is hybrid BM25 and vector search for local wiki pages?▼

Hybrid BM25 and vector search is a ranked retrieval method that combines keyword matching with semantic vector search and LLM re-ranking. It indexes local wiki pages on-device using qmd to return the most relevant pages and snippets.

How do I index an Obsidian-style vault for ranked search queries?▼

Indexing an Obsidian-style vault for ranked search is handled automatically. The Skill detects whether a vault is indexed, performs initial indexing or updates, and parses qmd JSON output into readable results with matching snippets.

Does this search tool require any external dependencies to work?▼

No external dependencies are strictly required. The tool detects missing qmd tooling and offers Homebrew or Cargo installation, but automatically falls back to recursive grep with frontmatter extraction if qmd is unavailable.

What is the best way to get ranked search results with snippets from a local vault?▼

The best way to get ranked search results from a local vault is using qmd for hybrid BM25 and vector search with LLM re-ranking. It outputs JSON with relevant pages and matching text snippets, ideal for sourcing citations or triaging results.