vault-research

Atomizes research reports into linked permanent notes in an Obsidian-style vault.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Long research and brainstorm reports are hard to reuse as knowledge: they sit as monolithic files that cannot be linked, searched, or built upon. This Skill converts reports from .mz/research or .mz/reports into small, claim-style atomic notes inside your vault's permanent folder, with full provenance frontmatter and suggested wikilinks to existing notes. ## Core Features & Use Cases - Noise-filtered atomization: Splits reports into H2 sections, excludes known noise sections (Vote Tally, Methodology, Panel Perspectives, etc.), and partitions the rest into 450-word windows for the atomization-proposer agent. - Approval-gated workflow: Three interactive gates (noise exclusion, atomization proposals, link suggestions) require explicit user approval before any vault writes occur. - Provenance and linking: Every note carries type: research, source_type: research-report, and report_path frontmatter, and the link-suggester agent proposes up to 5 typed relationships (supports, contradicts, extends) to existing vault notes. - Use Case: After running a deep-research pipeline that produced a 3000-word report, invoke this Skill to convert it into up to 15 atomic notes under permanent/research/, each linked to related notes already in your vault. ## Quick Start Ingest the report at .mz/research/2024-market-analysis.md into my vault as atomized research notes.

Frequently Asked Questions about vault-research

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

FAQPage Schema
How do I import a research report into my Obsidian vault as atomic notes?

Invoke vault-research with the report path, for example a file under .mz/research or .mz/reports. The skill parses the report into sections, filters noise, proposes atomic notes for your approval, then writes them to your vault's permanent folder under a research/ subfolder.

How does the skill split long reports for atomization?

Reports are split at H2 headings, then partitioned into sequential windows of at most 450 words, splitting oversize sections at sentence boundaries. Each window is dispatched separately to the atomization-proposer agent, which has a 500-word input cap.

Can I exclude or include specific report sections before notes are written?

Yes. A default noise list (Vote Tally, Methodology, Panel Perspectives, and similar) is applied, but the Phase 1.5 approval gate shows the full classification verbatim. You can reply with feedback to add or remove sections before any atomization begins.

When should I not use vault-research for vault ingestion?

Do not use it for raw multimodal captures like voice memos, images, PDFs, or YouTube links (use vault-ingest), for processing existing fleeting notes (use process-notes), or for proposing links between notes that already exist (use vault-connect).

What is the maximum number of notes created from one report?

The skill caps output at 15 notes per report. If merged proposals exceed the cap, near-duplicate titles are deduped first, then remaining proposals are truncated with a visible warning listing the dropped titles.

Does vault-research write to the vault without confirmation?

No. Three approval gates require explicit approval: noise exclusion, atomization proposals, and link suggestions. No vault writes occur until the proposals gate is approved, and rejecting the links gate leaves written notes untouched without a Related section.