Skip to main content
skill CX Codex

semantic-search — Claude Code skill for note search

The semantic-search Claude Code skill searches an Obsidian vault by meaning using local embeddings. It runs for finding related notes or recalling what you wrote about a topic.

MIT ★ 26 updated 2026-11-16

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add wrg32786/aigent-os --skill semantic-search -a claude-code
Open on GitHub

What semantic-search does

The skill finds notes in an Obsidian vault by meaning rather than relying on matching keywords. It creates embeddings with the local all-MiniLM-L6-v2 model, so searches make no API calls. search-vault.js runs queries; embed-vault.js builds the index and refreshes it after vault changes.

Installation and indexing use bash and node. The setup script takes the vault path: bash install.sh --target <vault>. Paths listed in index-deny.json are filtered out during indexing and checked again during searches. Without that file, both scripts process the entire vault; if the file cannot be read or parsed, they exit with an error.

What it helps with

  • find a note by meaning instead of exact keywords
  • locate notes covering a related subject
  • refresh the index after vault edits
  • keep selected folders out of search

Example prompts for the agent

  • Use /search to find notes about local embeddings.
  • Use /search to locate related Obsidian setup notes.
  • Use /search to recall what I wrote about semantic search.

How to install semantic-search

1Skills CLI (Vercel)

npx skills add wrg32786/aigent-os --skill semantic-search -a claude-code

2Manually: put the files in place

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

Copy the whole skill folder; for one project use .claude/skills/semantic-search/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about semantic-search

How do I install semantic-search in Claude Code?

Run npx skills add wrg32786/aigent-os --skill semantic-search -a claude-code. The skill installs at ~/.claude/skills/semantic-search/SKILL.md.

What does semantic-search do?

It searches an Obsidian vault by meaning with the local all-MiniLM-L6-v2 model. Queries use embeddings generated from the notes.

How can I exclude confidential notes from search?

Copy index-deny.example.json to index-deny.json and add vault-relative folder paths under deny_prefixes. Run embed-vault.js again to purge files from those folders that were already indexed.

Source text

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

Similar skills

All skills for AI and ML →
pgvector-semantic-search tigerdata pgvector-semantic-search configures AI agents to set up vector similarity search in PostgreSQL using pgvector. Helps store embeddings with halfvec, build HNSW indexes, and power RAG apps. CX Codex +1 1,000installs postgres-semantic-search laguagu The postgres-semantic-search Claude Code skill builds and tunes PostgreSQL retrieval. It covers semantic and hybrid search, evaluation, and troubleshooting weak results. CX Codex +1 227installs Vector Search — In-Memory TF-IDF Semantic Store axel-belfort Vector Search — In-Memory TF-IDF Semantic Store is an MCP server for Claude Code that indexes and searches small document collections in memory using TF-IDF and cosine similarity. CX Codex +1 3,562installs semantic-search-cwicr datadrivenconstruction semantic-search-cwicr finds similar construction work items in DDC CWICR cost databases using natural-language vector search. Covers 8 national bases in 26 languages. CX Codex +1 118installs Paparats – Local Semantic Code Search MCP IBazylchuk Paparats – Local Semantic Code Search MCP is an MCP server for Claude Code that searches multiple repositories by meaning and maintains project architecture memory. It helps agents navigate unfamiliar codebases. CX Codex +1 ★ 35repo stars Paper Search (arXiv + Semantic Scholar + OpenAlex) kangletian Paper Search (arXiv + Semantic Scholar + OpenAlex) is an MCP server for Claude Code that searches three academic sources. It helps find sources and inspect citations. CX Codex +1 4,064installs

From the same set58

The whole set →
skill-hunt The skill-hunt Claude Code skill finds skills that fill a capability gap. It ranks candidates, checks a selected skill, then installs it in quarantine. CX Codex +1 ★ 26repo stars Skill Audit The Skill Audit Claude Code skill checks skill usage and whether descriptions match the prompts that trigger them. It also flags idle skills and recurring work with no matching skill. CX Codex +1 ★ 26repo stars ship-adapter The ship-adapter Claude Code skill turns schemas and API contracts into adapters. It runs for database adapters, API client wrappers, interface adapters, and data transformers. CX Codex +1 ★ 26repo stars setup This Claude Code skill configures aigent-OS identity, priorities, and authority boundaries. Run /setup to configure the system or revise specific sections later. CX Codex +1 ★ 26repo stars Self-Review The Self-Review Claude Code skill sends substantial code changes through a focused second review. It targets multi-file edits, hot paths, prompts, and work that still feels uncertain. CX Codex +1 ★ 26repo stars scout-vault The scout-vault Claude Code skill finds related vault notes, links, and code definitions. It runs for note discovery, vault inventory, or call-chain searches. CX Codex +1 ★ 26repo stars Sandbox Routing Sandbox Routing — a skill for Claude Code routes large-file analysis and lengthy command output through sandbox tools. It activates when an agent needs a small detail without pulling the full output into context. CX Codex +1 ★ 26repo stars resume Restores context for unfinished work. Run /resume to compare the saved capsule with live memory and take the next step. CX Codex +1 ★ 26repo stars

Project sponsors

Companies that keep this analytics open