Deep Vault Research

SkillSearch

Use when the user asks a question about their vault, wants to explore a topic across notes, or says "research", "find out", "what do I know about", or "summarize my notes on". Chains semantic search, note reading, and link traversal for deep vault research.

Available today. Use it from your connected AI after setup.

Add ahel to your AI once: Claude, ChatGPT, Cursor, Claude Code or Codex. Then ask it to use this.

Then ask your AI: use the Deep Vault Research skill

What this skill tells your AI

The instructions your AI receives, as published by thoreinstein/gemini-obsidian in skills/research/SKILL.md and read by ahel’s review.

Research a topic across the user's Obsidian vault using a multi-pass approach.

Workflow

  1. Semantic Discovery — Call obsidian_rag_query with the user's question (limit 5-10). This surfaces the most relevant chunks across the vault.

  2. Targeted Reading — For each high-relevance result, call obsidian_read_note to get the full context. Skim for the most pertinent sections.

  3. Link Traversal — Check obsidian_get_links on the most relevant notes to find connected knowledge. Read promising linked notes.

  4. Synthesis — Combine findings into a clear answer with citations:

    • Reference specific notes by name: [[Note Name]]
    • Quote relevant passages when helpful
    • Note any gaps or contradictions in the vault's knowledge

Arguments

The user's query follows the skill invocation. Example: /research what do I know about authentication patterns

Tips

  • If RAG returns no results, suggest running /index first
  • For broad topics, do multiple RAG queries with different phrasings
  • Always cite which notes your answer draws from

Signals

GitHub stars
102
Forks
9
Last commit
Jul 2026
Hacker News mentions
20
Advanced
Item type
skill
Key
research-thoreinstein
Source
github.com/thoreinstein/gemini-obsidian