sem-search-a

Search vault notes using BM25, vector search, and re-ranking.

1|Updated Jan 25, 2026
One-click install
npx skills add https://github.com/JSai23/claude-tooling --skill sem-search-a
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sem-search-a
Source: https://github.com/JSai23/claude-tooling/tree/main/plugins/vault/skills/sem-search-a
Command: npx skills add https://github.com/JSai23/claude-tooling --skill sem-search-a

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Semantic search across vault notes is needed to surface conceptually related content when keyword matching fails, enabling faster discovery and better knowledge organization.

Core Features & Use Cases

  • Semantic search combines BM25, vector search, and LLM re-ranking to surface meaningfully related notes.
  • Reindexing rebuilds embeddings and indexes after vault changes to keep results current.
  • Use Case: You want to locate notes about "agent-based systems" even if you don't remember exact terms, by querying for related concepts.

Quick Start

Provide a query text to search notes semantically, or run with --reindex to rebuild the index.

Frequently Asked Questions about sem-search-a

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I perform semantic search across my notes vault?

To perform semantic search across your notes vault, provide query text to find conceptually related content using BM25, vector search, and LLM re-ranking. This surfaces meaningfully related notes even when exact terms are forgotten.

How does hybrid search combine BM25 and vector search?

Hybrid search combines BM25 and vector search by applying both techniques to vault notes and using LLM re-ranking to refine results. This method surfaces conceptually related content that keyword matching alone fails to find.

Do I need a local embeddings model for semantic search?

Yes, you need a local embeddings model and the qmd tool available in your environment to perform semantic search and generate the vector representations required for finding conceptually related notes.

What is the best way to find related notes when keyword matching fails?

The best way to find related notes when keyword matching fails is using local semantic search. It applies BM25, vector search, and re-ranking to locate conceptually related notes by querying meaning rather than exact terms.

How do I reindex my notes vault after adding new files?

To reindex your notes vault after adding new files, run the tool with the --reindex flag. This rebuilds embeddings and indexes to ensure semantic search results remain current with vault changes.

Why does semantic search return outdated results from my notes vault?

Semantic search returns outdated results from your notes vault when indexes are stale. Run with --reindex to rebuild embeddings and indexes after vault changes, keeping search results current.