search · thoreinstein — Claude Code skill: note search and installation
search finds Obsidian notes by query text or filename. Use it to locate words in note contents and file names, then choose a match to read.
ISC ★ 102 updated 2026-10-25
npx skills add thoreinstein/gemini-obsidian --skill search -a claude-codeWhat search does
The skill sends the query to obsidian_search_notes, lists the matching files, and asks which result you want to open. Matching is based on text in filenames or note contents, not on meaning or related concepts.
Search results are capped at 20. The description points to /research for meaning-based lookup, so search is suited to queries with specific words or filenames.
For Claude Code, run npx skills add thoreinstein/gemini-obsidian --skill search -a claude-code; the skill file is at ~/.claude/skills/search/SKILL.md. Gemini CLI is also supported.
What it helps with
- find notes containing a keyword
- locate a file by its name
- review matching notes in a list
- choose a matching note to read
Example prompts for the agent
- Find notes about recipes.
- Look for files with “plans” in the name.
- Search my notes for “moving” and show the matches.
How to install search
1Skills CLI (Vercel)
npx skills add thoreinstein/gemini-obsidian --skill search -a claude-code2Manually: put the files in place
~/.claude/skills/search/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/search/
1Skills CLI (Vercel)
npx skills add thoreinstein/gemini-obsidian --skill search -a codex2Manually: put the files in place
.agents/skills/search/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add thoreinstein/gemini-obsidian --skill search -a cursor2Manually: put the files in place
.cursor/skills/search/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install thoreinstein/gemini-obsidian skills/search2Manually: put the files in place
.github/skills/search/SKILL.md1Skills CLI (Vercel)
npx skills add thoreinstein/gemini-obsidian --skill search -a gemini-cli2Platform CLI
gemini skills install https://github.com/thoreinstein/gemini-obsidian --path skills/searchManually: put the files in place
.devin/skills/search/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 search
How do I install search in Claude Code?
Run npx skills add thoreinstein/gemini-obsidian --skill search -a claude-code. The skill file is located at ~/.claude/skills/search/SKILL.md.
What does the search skill do?
It looks for query text in note contents and filenames, lists matching files, and asks which one you want to read.
How many results can search return?
The results are capped at 20 matches. For meaning-based lookup, the skill description suggests /research.
Source text
SKILL.md · ISC
--- name: search description: >- Use when the user wants to find notes by keyword or filename, or says "search", "find notes", or "look for". --- # Search Vault Search for notes by keyword or filename match. ## Workflow 1. Call `obsidian_search_notes` with the user's query 2. Present matching files in a clear list 3. Ask if the user would like to read any of the results ## Arguments The search query follows the skill invocation. Example: `/search cooking recipes` ## Tips - This is a simple text match (keyword in filename or content) - For semantic/meaning-based search, suggest `/research` instead - Results are capped at 20 matches
© thoreinstein · ISC · thoreinstein/gemini-obsidian
Similar skills
All skills for Notes, tasks and projects →search by other authors comes first.