skills.rest
NaoyaMiyagawa
NaoyaMiyagawaCOMMUNITY
Explore all skills by this author →
𝕏@_miya_nm7GitHub

custom-obsidian-wiki-query

Query an Obsidian knowledge vault with qmd hybrid search to answer domain and codebase questions.

1|Updated Apr 3, 2021
Search Tags:#documentation#semantic search#knowledge base#obsidian#wiki#qmd#codebase questions
One-click install
npx skills add https://github.com/NaoyaMiyagawa/dotfiles --skill custom-obsidian-wiki-query-naoyamiyagawa
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: custom-obsidian-wiki-query
Source: https://github.com/NaoyaMiyagawa/dotfiles/tree/main/.ai/skills/custom-obsidian-wiki-query
Command: npx skills add https://github.com/NaoyaMiyagawa/dotfiles --skill custom-obsidian-wiki-query-naoyamiyagawa

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Answers domain, architecture, and codebase questions by searching a personal Obsidian knowledge wiki instead of re-reading source code, returning cited answers grounded in documented project knowledge. ## Core Features & Use Cases - Hybrid Vault Search: Runs structured qmd queries (intent, lexical, and vector fields) against the indexed obsidian collection, with BM25 search and Grep/Read fallbacks. - Cited Answers: Synthesizes answers from full wiki pages, citing them as [[Page]] links and surfacing open questions recorded in the vault. - Honest Gap Handling: States when the wiki lacks coverage and offers to ingest answers from the actual codebase, optionally filing new pages back per vault conventions. - Use Case: While working in a repository, ask "how does the billing service auth work" and receive an answer synthesized from the project's wiki pages with citations, without manually searching the vault. ## Quick Start Ask what the wiki says about how a specific module or feature in this project works.

Frequently Asked Questions about custom-obsidian-wiki-query

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

FAQPage Schema
How do I search an Obsidian vault from the command line?▼

Use the qmd CLI against the indexed obsidian collection. Run qmd query with intent, lex, and vec fields for hybrid search, or qmd search for BM25-only lookups, then retrieve full pages with qmd get or qmd multi-get.

How do I answer codebase questions from a project wiki?▼

Scope the project from the user's prompt or current repository name, run a qmd query tuned to that topic, pull the top pages in full, and synthesize an answer citing each page as a [[wikilink]] while distinguishing documented fact from inference.

What is the difference between qmd query and qmd search?▼

qmd query runs hybrid lexical plus semantic search using structured intent, lex, and vec fields you author. qmd search is BM25-only and faster when you already know exact page titles, phrases, or code symbols.

What happens if qmd semantic search is unavailable?▼

If model-backed qmd commands fail because models or GPU are unavailable, fall back to qmd search for BM25 results, then to direct Grep and Read over the resolved $OBSIDIAN_VAULT paths.

Can this skill write new pages to the Obsidian vault?▼

It is read-only by default. It only creates or updates pages under projects/<name>/wiki/ when the user explicitly asks or confirms, following vault conventions and re-indexing with qmd update and qmd embed afterward.

Related Skills

Explore More Software Engineering Skills→
EndUser123EndUser123

qmd-wiki

Ingest, query, lint, and index QMD wiki pages into an Obsidian vault.

Community
Intermediate
byriderbyrider

wiki-query

Query the Obsidian wiki and synthesize cited answers from cached pages.

Official
Intermediate
paperclipaipaperclipai
79.8k

wiki-query

Retrieve and synthesize information from wiki pages and raw sources with citations.

Official
Intermediate
TokenRollAITokenRollAI
459

investigate

Investigate codebase questions using llmdoc documentation and report findings.

Official
Intermediate