wiki-query

What it does

Answer questions by searching the compiled Obsidian wiki. It supports questions about the user’s knowledge base, cross-wiki queries, and multi-hop connections between topics by walking typed edges across multiple hops. It can provide synthesized answers with citations from wiki pages and can operate in an index-only fast mode. It also accepts inline-vault routing like "wiki-query @work what do I know about X" via a Config Resolution Protocol.

How it works

The skill instructs the agent to act on a read-only wiki, using a tiered retrieval pipeline:

• Resolve configuration and load wiki settings.
• Start with a GraphRAG pre-pass to classify the query and identify candidate pages without reading bodies.
• If needed, perform an index pass to build a candidate set from frontmatter (title, tags, aliases, summary) and order by relevance and tier.
• Optionally use QMD if configured to augment results, with guardrails to drop any _raw/ paths.
• In Step 3, fetch relevant sections around query terms from top candidates without full-page reads.
• If still inconclusive, perform full reads of up to three top pages in a prioritized order, with special handling for relationship queries to surface typed edges from frontmatter.
• For path/multi-hop questions, run a dedicated multi-hop graph traversal using typed edges defined in frontmatter, performing a bounded BFS and reporting the chain with edge types.
• Do not modify wiki content; only possible write is a single append to log.md in Step 6.

When to use it

Use this skill for questions like:

• "what do I know about X" or "find everything related to Y"—information is synthesized with citations.
• Exploring connections or planning multi-hop questions like "how is X connected to Y" or "trace the chain from X to Z".
• When you need to walk typed edges across multiple hops to establish relationships.
• A fast index-only mode is available via keywords like "quick answer" or "fast lookup" to rely on summaries and frontmatter without page bodies.

What it can touch

It uses the following tools and inputs as specified in the skill: the graph index and page frontmatter for retrieval; optional QMD sources if configured; and grep-based access to files in the wiki vault. It does not edit content.

Caveats

• The skill is READ-ONLY and must not create or modify wiki content; only appends to log.md are permitted.
• In multi-hop traversal, it relies on frontmatter edges and may not read full page bodies unless necessary.
• If the wiki collection includes misconfigured paths (e.g., _raw/), results may be filtered accordingly and noted in updates.
• Outcomes are limited to what is stated in the wiki frontmatter, summaries, and cited pages; it will not fabricate new facts.