wiki-query

Answers questions by searching a compiled Obsidian wiki with graph traversal and citations.

Updated Nov 9, 2023
One-click install
npx skills add https://github.com/oresttokovenko/dot-files --skill wiki-query-oresttokovenko
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wiki-query
Source: https://github.com/oresttokovenko/dot-files/tree/main/chezmoi/dot_agents/skills/wiki-query
Command: npx skills add https://github.com/oresttokovenko/dot-files --skill wiki-query-oresttokovenko

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Finding answers scattered across a large personal knowledge base requires manually opening many notes; this Skill retrieves and synthesizes answers from a compiled Obsidian wiki with cited sources, without ever modifying wiki content. ## Core Features & Use Cases - Tiered Retrieval Pipeline: Escalates from a graph index pre-pass through frontmatter grep, section reads, and full page reads only as needed, minimizing cost. - Multi-hop Graph Traversal: Answers "how is X connected to Y" questions by walking typed relationship edges across up to 3 hops, reporting the full chain. - Structural Graph Intents: Computes impact analysis, bridge pages, hubs, clusters, and surprising connections directly from the compiled graph with no page reads. - Use Case: Ask "what do I know about transformer attention mechanisms?" and receive a synthesized answer with [[wikilink]] citations, staleness annotations, a retrieval transparency report, and identified knowledge gaps. ## Quick Start Ask the agent to search your wiki for everything you know about a topic and synthesize an answer 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 with an AI agent?

Ask a natural-language question and the skill runs a graph-query pre-pass over the compiled wiki index, then escalates through frontmatter grep, section reads, and full page reads only as needed. Answers include [[wikilink]] citations to source pages.

How do I find connections between two notes in Obsidian?

Ask a multi-hop question like "how is X connected to Y" and the skill walks typed relationship edges across the wiki graph, up to 3 hops by default. It reports the full chain with edge types and flags any reverse or untyped hops.

Can wiki-query edit or create pages in my Obsidian vault?

No, the skill is strictly read-only except for appending one line to log.md per query. If your message implies a change, it proposes the edit and routes you to wiki-capture or wiki-update instead.

What happens if the obsidian-wiki CLI is not installed?

The skill falls back to grep-based retrieval over index.md and page frontmatter, which remains fully functional. QMD semantic search is also optional and skipped when its collection variable is unset.

How do I get a fast answer without reading full wiki pages?

Use trigger phrases like "quick answer", "just scan", or "fast lookup" to activate index-only mode. The skill answers from page summaries and frontmatter only, clearly labeling the answer as index-only.

Does wiki-query handle outdated or superseded wiki pages?

Yes, pages with expired valid_until frontmatter drop out of candidates by default, and cited pages are annotated as stale, disputed, or archived based on lifecycle metadata. Use --as-of or --include-historical for past-state queries.