origin-obsidian-research

Search an Obsidian vault with vector queries and return sourced research summaries.

Updated Dec 9, 2025
One-click install
npx skills add https://github.com/Aki2022/skills --skill origin-obsidian-research-aki2022
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: origin-obsidian-research
Source: https://github.com/Aki2022/skills/tree/main/origin-obsidian-research
Command: npx skills add https://github.com/Aki2022/skills --skill origin-obsidian-research-aki2022

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? It lets you investigate a topic using only your own Obsidian vault (saved papers, article clips, scanned-material notes) instead of the open web, returning organized findings with source links back to the original notes. ## Core Features & Use Cases - Vector search over your vault: Runs semantic search via the external vector.sh script with deduplication and absolute note links. - Structured, cited answers: Groups results by theme and perspective, attaching each claim to its source note link. - Strict trigger boundaries: Activates only when the user explicitly references obsidian/vault/notes/vector search, avoiding misfires on general web-research requests. - Use Case: Ask to investigate colorectal cancer care challenges from your saved papers, split into medical and public-policy perspectives, and receive a summary with links to the underlying notes. ## Quick Start Ask the assistant to search your Obsidian vault for a specific theme, for example: use obsidian to research dementia prevention and organize the findings by perspective with source links.

Frequently Asked Questions about origin-obsidian-research

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

FAQPage Schema
How do I search my Obsidian vault with vector search?

Run the vector.sh script from the obsidian_code repository with a search query, using the --dedupe and --abs-links flags. The script resolves the vault location itself via the OBSIDIAN_DATA_ROOT environment variable, so no vault path is needed.

When should I use vault search instead of web search?

Use vault search when the information source is your own saved notes, papers, or clips and the request explicitly mentions obsidian, vault, notes, or vector search. For latest news, fact-checking, or general questions, web search is the appropriate tool.

Why does vault search return no results for recent notes?

The search index may be outdated, so newly added notes are not yet indexed. Run vector.sh with the update command to rebuild the index, then repeat the search.

Why does reading a note fail with ETIMEDOUT errors?

The vault lives on cloud-synced storage, so file reads can time out even when directory listing works. Retry a few times; if it still fails, answer from the search preview and explicitly report which notes could not be read.

Can I open the returned note links on my phone?

The absolute note links are clickable on macOS but do not open on smartphones. On mobile, ask the assistant to read the specific note, and it will return the file contents directly.