research · thoreinstein — Claude Code skill: what it does, how to install
research is a Claude Code skill that searches an Obsidian vault, reads relevant notes, and follows links to answer questions about stored knowledge.
ISC ★ 102 updated 2026-10-25
npx skills add thoreinstein/gemini-obsidian --skill research -a claude-codeWhat research does
This skill researches a user’s question across an Obsidian vault. It starts with obsidian_rag_query to locate relevant passages, opens the strongest matches through obsidian_read_note, then checks related material with obsidian_get_links.
The final response combines the findings and points to source notes with [[Note Name]] references. It can include useful excerpts and call out gaps or conflicting notes. The skill runs in Claude Code and Gemini CLI. When the RAG search returns nothing, run /index first, because the research flow needs an indexed vault to find relevant material.
What it helps with
- find notes related to a research question
- read full context around relevant passages
- follow links between connected vault notes
- combine findings with note references
- spot gaps or contradictions across notes
Example prompts for the agent
- Research what I know about authentication patterns:
/research what do I know about authentication patterns - Explore my notes on database migrations and follow the connected entries with
/research database migrations - Summarize everything in my vault about API testing:
/research summarize my notes on API testing
How to install research
1Skills CLI (Vercel)
npx skills add thoreinstein/gemini-obsidian --skill research -a claude-code2Manually: put the files in place
~/.claude/skills/research/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/research/
1Skills CLI (Vercel)
npx skills add thoreinstein/gemini-obsidian --skill research -a codex2Manually: put the files in place
.agents/skills/research/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add thoreinstein/gemini-obsidian --skill research -a cursor2Manually: put the files in place
.cursor/skills/research/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install thoreinstein/gemini-obsidian skills/research2Manually: put the files in place
.github/skills/research/SKILL.md1Skills CLI (Vercel)
npx skills add thoreinstein/gemini-obsidian --skill research -a gemini-cli2Platform CLI
gemini skills install https://github.com/thoreinstein/gemini-obsidian --path skills/researchManually: put the files in place
.devin/skills/research/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about research
How do I install research in Claude Code?
Run npx skills add thoreinstein/gemini-obsidian --skill research -a claude-code, then check ~/.claude/skills/research/SKILL.md.
What does the research skill do?
It searches an Obsidian vault, reads the most relevant notes, follows their links, and builds an answer with references to the notes it used.
What should I do when the search finds nothing?
Run /index and repeat the research request. For broad subjects, use several differently worded research queries.
Source text
SKILL.md · ISC
--- name: research description: >- 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. --- # Deep Vault Research 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
© thoreinstein · ISC · thoreinstein/gemini-obsidian
Similar skills
All skills for Agent setup: memory, context, orchestration →research by other authors comes first.