vault-answer

Answers questions from Obsidian vault notes with inline wikilink citations and explicit unknowns.

2|Updated Apr 4, 2026
One-click install
npx skills add https://github.com/DoctorMozg/claude-pipelines --skill vault-answer-doctormozg
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: vault-answer
Source: https://github.com/DoctorMozg/claude-pipelines/tree/main/plugins/mz-knowledge/skills/vault-answer
Command: npx skills add https://github.com/DoctorMozg/claude-pipelines --skill vault-answer-doctormozg

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When you ask a question about your own notes, general LLM answers ignore what your vault actually contains. This Skill grounds every answer strictly in your Obsidian vault, citing the exact notes behind each claim and explicitly listing what the vault could not answer. ## Core Features & Use Cases - Grounded Q&A with citations: Dispatches a vault-query-answerer agent that searches your vault, reads up to 20 notes, and writes an answer where every factual claim carries an inline [[wikilink]] citation. - Explicit Unknowns section: Always surfaces what the vault does not cover, so gaps in your knowledge base become visible instead of being silently filled with general knowledge. - Citation density enforcement: Measures citation-to-word ratio (minimum 0.02) and retries once if the answer is under-cited, keeping the citation trail auditable. - Use Case: Ask "what does my vault say about database indexing trade-offs" and receive a verbatim answer with linked source notes, a Sources list, and an Unknowns list — without any vault files being modified. ## Quick Start Ask the assistant to answer a question from your vault notes with citations, for example: what does my vault say about my meeting notes on the Q3 roadmap?

Frequently Asked Questions about vault-answer

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

FAQPage Schema
How do I get answers from my Obsidian vault notes with citations?

Invoke the skill with your question, for example "what does my vault say about X". It searches vault notes, reads up to 20 of them, and returns an answer where every factual claim carries an inline [[wikilink]] citation plus a Sources list.

How does vault-answer find my Obsidian vault path?

It resolves the vault path from the OBSIDIAN_VAULT_PATH environment variable first, then MZ_VAULT_PATH, then walks up from the working directory looking for a .obsidian folder. If none resolve, it asks you directly.

Does vault-answer modify or write to my Obsidian notes?

No. The skill is strictly read-only on the vault. It only writes artifacts like answer.md and state.md inside a .mz/task/<task_name>/ directory, never touching vault files.

What happens when my vault does not contain the answer?

The answer always includes an ## Unknowns section listing aspects the vault could not support. A thin vault produces a longer Unknowns list rather than fabricated content from general knowledge.

Why does the skill enforce a citation density check?

The check requires at least one [[wikilink]] per 50 words of answer prose (ratio 0.02) to keep every claim auditable. If the first attempt falls short, the agent retries once; persistent shortfalls are flagged as a concern in state.

When should I not use vault-answer?

Do not use it for editing notes, finding links between notes (use vault-connect), frontmatter or schema questions (use vault-schema), or general questions unrelated to vault content, which can be answered directly.