wiki-query

Answers questions against a compiled Obsidian wiki using tiered retrieval and graph traversal.

Updated Aug 2, 2026
One-click install
npx skills add https://github.com/phm-aguiar/test_documentacao --skill wiki-query-phm-aguiar
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: wiki-query
Source: https://github.com/phm-aguiar/test_documentacao/tree/main/.claude/skills/wiki-query
Command: npx skills add https://github.com/phm-aguiar/test_documentacao --skill wiki-query-phm-aguiar

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Searching a large personal knowledge base by hand is slow and error-prone. This Skill answers natural-language questions against a compiled Obsidian wiki using a tiered retrieval strategy, returning synthesized answers with citations instead of raw file dumps. ## Core Features & Use Cases - Tiered Retrieval: Escalates from cheap index lookups to section greps to full page reads, minimizing context usage while maximizing answer quality. - Multi-hop Graph Traversal: Traces typed relationship edges (e.g., "contradicts", "derived_from") across pages to answer path queries like "how is X connected to Y". - Semantic and Hybrid Search: Supports embedding-based cosine similarity and BM25 hybrid scoring via a SQLite index, plus optional QMD integration for lexical and vector search. - Use Case: Ask "what do I know about transformer attention mechanisms" and receive a synthesized answer with [[wikilink]] citations, staleness annotations, and identified knowledge gaps. ## Quick Start Ask the assistant to search your Obsidian wiki for everything related to a topic and synthesize an answer with page 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 an Obsidian vault with natural language questions?▼

Use tiered retrieval: start with the vault index and frontmatter grep to find candidate pages, then grep relevant sections, and only read full pages when needed. Semantic mode embeds the query with all-MiniLM-L6-v2 for conceptual questions.

What is the difference between semantic and hybrid search modes?▼

Semantic mode ranks results by cosine similarity of embeddings, suiting conceptual queries. Hybrid mode combines cosine similarity with BM25 lexical scoring using the formula 0.7 * cosine + 0.3 * bm25, which works better for technical terms in broad contexts.

How do I trace connections between notes in a knowledge graph?▼

Multi-hop traversal builds a typed-edge adjacency from frontmatter relationships blocks, then runs bounded BFS up to 3 hops from the source page. It reports paths with edge types and flags reverse or untyped fallback edges as weaker chains.

Can this skill edit or create wiki pages?▼

No, it is strictly read-only except for appending one query log line to log.md. If a change is needed, it proposes the edit and routes you to the appropriate capture or update skill instead of modifying content.

Why does semantic search report no index found?▼

Semantic mode requires a pre-built SQLite index at ~/.claude/wiki_index.db. If the index is missing or empty, run the indexer first to embed wiki pages before using the --semantic flag.