К основному содержанию
скилл CX Codex

semantic-search — скилл для Claude Code: поиск по заметкам

Скилл semantic-search для Claude Code ищет заметки в хранилище Obsidian по смыслу с помощью локальных эмбеддингов. Запускается для поиска похожих записей и воспоминаний о написанном.

MIT ★ 26 обновлён 2026-11-16

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add wrg32786/aigent-os --skill semantic-search -a claude-code
Открыть на GitHub

Что делает 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-code

2Вручную: положить файлы

~/.claude/skills/semantic-search/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/semantic-search/

По шагам, с командами для каждой платформы: Как установить скилл в 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

Похожие скиллы

Все скиллы по теме «ИИ и ML» →
pgvector-semantic-search tigerdata Скилл pgvector-semantic-search учит агента настраивать векторный поиск в PostgreSQL с помощью pgvector. Он помогает хранить эмбеддинги, строить индексы HNSW и готовить базу к задачам RAG. CX Codex +1 1 000установок postgres-semantic-search laguagu Скилл postgres-semantic-search для Claude Code настраивает поиск и извлечение данных в PostgreSQL. Помогает собрать семантический или гибридный поиск, оценить качество результатов и разобраться со слабыми совпадениями. CX Codex +1 227установок Vector Search — In-Memory TF-IDF Semantic Store axel-belfort MCP-сервер Vector Search — In-Memory TF-IDF Semantic Store для Claude Code ищет семантические совпадения в небольших наборах документов с помощью TF-IDF и косинусного сходства в оперативной памяти. CX Codex +1 3 562установок semantic-search-cwicr datadrivenconstruction Скилл semantic-search-cwicr находит похожие позиции в строительных расценках DDC CWICR через векторный поиск на естественном языке. Работает с 8 национальными базами в 26 языках. CX Codex +1 118установок Paparats – Local Semantic Code Search MCP IBazylchuk Paparats – Local Semantic Code Search MCP — MCP-сервер для Claude Code: ищет по смыслу в нескольких репозиториях и хранит архитектурную память проекта. Помогает агенту ориентироваться в незнакомой кодовой базе. CX Codex +1 ★ 35звёзд репо Paper Search (arXiv + Semantic Scholar + OpenAlex) kangletian Paper Search (arXiv + Semantic Scholar + OpenAlex) — MCP-сервер для Claude Code, который ищет статьи в трёх научных источниках. Помогает находить источники и анализировать цитирование. CX Codex +1 4 064установок

Из того же набора58

Весь набор →
skill-hunt Скилл skill-hunt для Claude Code ищет навыки, которые закрывают пробел в возможностях агента. Он ранжирует кандидатов, проверяет выбранный скилл и устанавливает его в карантин. CX Codex +1 ★ 26звёзд репо Skill Audit Скилл Skill Audit для Claude Code проверяет, какие навыки вызываются и совпадают ли их описания с запросами. Он также ищет неиспользуемые навыки и повторяющиеся задачи без подходящего навыка. CX Codex +1 ★ 26звёзд репо ship-adapter Скилл ship-adapter для Claude Code переносит схемы и контракты API в адаптеры. Запускается при создании адаптера базы данных, API-клиента или преобразователя данных. CX Codex +1 ★ 26звёзд репо setup Настраивает identity, приоритеты и границы полномочий aigent-OS. Запускается командой /setup для первичной или повторной настройки отдельных разделов. CX Codex +1 ★ 26звёзд репо Self-Review Скилл Self-Review для Claude Code запускает отдельную проверку кода перед завершением работы. Он включается для крупных или межфайловых изменений, горячих участков кода и при сомнениях в результате. CX Codex +1 ★ 26звёзд репо scout-vault Скилл scout-vault для Claude Code ищет связанные заметки, ссылки и определения кода. Запускается для инвентаризации хранилища или обхода цепочек вызовов. CX Codex +1 ★ 26звёзд репо Sandbox Routing Скилл Sandbox Routing для Claude Code направляет чтение больших файлов и длинный вывод команд через инструменты песочницы. Он включается, когда агенту нужно извлечь отдельные данные без загрузки всего вывода в контекст. CX Codex +1 ★ 26звёзд репо resume Восстанавливает контекст незавершённой работы. По команде /resume он сверяет капсулу с актуальной памятью и выполняет следующий шаг. CX Codex +1 ★ 26звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой