wiki-query

Search compiled Obsidian wikis and return synthesized, cited answers.

Updated Apr 6, 2026
One-click install
npx skills add https://github.com/Nero-kk/claude-agent-skills --skill wiki-query
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wiki-query
Source: https://github.com/Nero-kk/claude-agent-skills/tree/main/claude-skills/wiki-query
Command: npx skills add https://github.com/Nero-kk/claude-agent-skills --skill wiki-query

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill answers user questions by efficiently searching a compiled Obsidian wiki, removing the need to manually scan many markdown files and synthesize scattered notes.

Core Features & Use Cases

  • Index-first retrieval: Quickly finds candidate pages using index.md and frontmatter-only greps to minimize expensive reads.
  • Tiered search pipeline: Supports index-only fast mode, optional QMD semantic searches, section-level greps, and full-page reads with controlled escalation.
  • Cited synthesis and transparency: Produces synthesized answers with [[wikilinks]], states which retrieval step produced each claim, and logs queries to log.md for auditing.
  • Use Case: Ask what is known about a concept across your project vault and receive a synthesized answer with page citations and noted gaps.

Quick Start

Ask the wiki-query skill: Find everything the vault has on "transfer learning" and summarize the key points with citations.

Frequently Asked Questions about wiki-query

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

FAQPage Schema
How do I search my Obsidian wiki and get synthesized answers with citations?

To search an Obsidian wiki for synthesized answers, query the compiled vault to receive cited responses with [[wikilinks]]. The system performs tiered retrieval using index metadata and page frontmatter to locate and synthesize relevant pages.

What is the best way to perform semantic search across an Obsidian vault?

Performing semantic search across an Obsidian vault is best handled by an optional QMD semantic search step within a tiered retrieval pipeline. This escalates from index-only lookups to section greps and full-page reads, respecting the QMD_WIKI_COLLECTION setting.

Does wiki-query work with raw Obsidian markdown files or does the vault need compiling?

Wiki-query works with a compiled Obsidian wiki rather than raw markdown files directly. It relies on a compiled vault, an index.md file, and page frontmatter to execute efficient tiered retrieval and answer factual lookups.

How do I find knowledge gaps and relationships in my Obsidian notes?

Finding knowledge gaps and relationships in Obsian notes requires querying the compiled vault using index metadata and frontmatter. The system analyzes retrieved pages to perform relationship queries, synthesis tasks, and gap analysis, noting missing information.

Why does my Obsidian wiki query return an error about OBSIDIAN_VAULT_PATH?

An Obsidian wiki query returns an OBSIDIAN_VAULT_PATH error when the required environment variable is unset or incorrectly configured. The retrieval pipeline strictly respects this path to locate the compiled vault files and append query logs to log.md.