semantic-search — скилл для Claude Code: поиск по заметкам
Скилл semantic-search для Claude Code ищет заметки в хранилище Obsidian по смыслу с помощью локальных эмбеддингов. Запускается для поиска похожих записей и воспоминаний о написанном.
MIT ★ 26 обновлён 2026-11-16
npx skills add wrg32786/aigent-os --skill semantic-search -a claude-codeЧто делает semantic-search
Скилл ищет заметки в хранилище Obsidian по смыслу, а не только по ключевым словам. Для эмбеддингов он использует локальную модель all-MiniLM-L6-v2, поэтому запросы не отправляются к API. Поиск запускает скрипт search-vault.js, а embed-vault.js создаёт индекс и обновляет его после изменений.
Для установки и индексации нужны bash и node. Скрипт установки принимает путь к хранилищу: bash install.sh --target <vault>. Файлы из путей в index-deny.json исключаются из индексации и повторно фильтруются при поиске. Без этого файла скрипты индексируют и ищут во всём хранилище; если файл нельзя прочитать или разобрать, они завершаются с ошибкой.
Какие задачи решает
- найти заметку по смыслу, а не по точным словам
- отыскать записи на похожую тему
- обновить индекс после изменений в хранилище
- исключить конфиденциальные папки из поиска
Примеры запросов агенту
- Найди в заметках записи о локальных эмбеддингах через
/search. - Поищи похожие заметки о настройке Obsidian через
/search. - Вспомни, что я писал о семантическом поиске, через
/search.
Как установить semantic-search
1Через Skills CLI (Vercel)
npx skills add wrg32786/aigent-os --skill semantic-search -a claude-code2Вручную: положить файлы
~/.claude/skills/semantic-search/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/semantic-search/
1Через Skills CLI (Vercel)
npx skills add wrg32786/aigent-os --skill semantic-search -a codex2Вручную: положить файлы
.agents/skills/semantic-search/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add wrg32786/aigent-os --skill semantic-search -a cursor2Вручную: положить файлы
.cursor/skills/semantic-search/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install wrg32786/aigent-os skills/semantic-search2Вручную: положить файлы
.github/skills/semantic-search/SKILL.md1Через Skills CLI (Vercel)
npx skills add wrg32786/aigent-os --skill semantic-search -a gemini-cli2Командой платформы
gemini skills install https://github.com/wrg32786/aigent-os --path skills/semantic-searchВручную: положить файлы
.devin/skills/semantic-search/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add wrg32786/aigent-os --skill semantic-search -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о semantic-search
Как установить semantic-search в Claude Code?
Выполни npx skills add wrg32786/aigent-os --skill semantic-search -a claude-code. Скилл устанавливается в ~/.claude/skills/semantic-search/SKILL.md.
Что делает semantic-search?
Ищет заметки в хранилище Obsidian по смыслу с помощью локальной модели all-MiniLM-L6-v2. Для поиска по запросу используются эмбеддинги заметок.
Как исключить конфиденциальные заметки из поиска?
Скопируй index-deny.example.json в index-deny.json и добавь в deny_prefixes пути папок относительно хранилища. Затем заново запусти embed-vault.js, чтобы удалить уже проиндексированные файлы из этих папок.
Исходный текст
SKILL.md · MIT
--- name: semantic-search description: "Search vault notes by meaning with local embeddings. Use when finding similar notes, searching notes semantically, or recalling what you wrote about." trigger: /search --- # Vault Semantic Search Search the Obsidian vault by meaning, not just keywords. Uses local `all-MiniLM-L6-v2` model — no API calls, no data leaves your machine. ## Usage ```bash # Search by meaning node daemons/semantic-search/search-vault.js "your query here" # Re-index (run after significant vault changes) node daemons/semantic-search/embed-vault.js # Re-index only changed files node daemons/semantic-search/embed-vault.js --changed-only ``` ## Setup ```bash bash install.sh --target <vault> # installs or repairs the dependencies safely cd daemons/semantic-search && node embed-vault.js # Initial index (~30 seconds) ``` ## Confidential-class deny list If your vault also holds client work, deal notes, or anything under NDA, keep it out of the index: ```bash cd daemons/semantic-search cp index-deny.example.json index-deny.json # then edit index-deny.json and list your own folders ``` Each entry in `deny_prefixes` is a vault-relative path prefix, matched case-insensitively and with either slash style. `embed-vault.js` drops matching files before they are embedded, so their text never reaches `embeddings.json` (which stores note excerpts in plaintext). `search-vault.js` re-checks the same list at query time, so an index built before you added a prefix still can't return one. Only `index-deny.example.json` is tracked by git. Your `index-deny.json` is gitignored, because the names of your confidential folders are themselves confidential. With no `index-deny.json` at all, both scripts index and search everything and print a notice on stderr saying so. If the file exists but can't be read or parsed, they exit non-zero instead of falling back to an unfiltered index. Add a prefix the same session confidential material enters your vault, then re-run `embed-vault.js`: it also purges anything already indexed under a newly added prefix.
© wrg32786 · MIT · wrg32786/aigent-os