embeddings-search-skill

Embeddings Search Skill

A Claude Code plugin that provides hybrid document search combining grep (literal matching) with semantic embeddings for comprehensive search across project documents.

Part of [The-Focus-AI/claude-marketplace](https://github.com/The-Focus-AI/claude-marketplace).

Features

• Hybrid Search: Combines literal text matching (grep) with semantic similarity (embeddings)
• Chunking Strategies: Sliding window, paragraph, or sentence-based chunking
• Metadata Extraction: Automatically extracts collections, document types, authors, and topics
• Taxonomy Discovery: Browse discovered collections, document types, authors, and topics
• Unified Index: Single .embeddings/index.json file for fast loading
• Date & Metadata Filtering: Search within specific time ranges and filter by metadata
• Auto-indexing: Automatically indexes documents on first search
• Incremental Updates: Only re-indexes changed files

Installation

Install via Claude Code plugin marketplace or add directly:

claude --plugin-dir /path/to/embeddings-search-skill

Usage

The skill activates automatically when searching for documents by meaning:

• "Find documents about budget planning"
• "Search for discussions about the Q4 review"
• "Look for files related to authentication"

Manual CLI Usage

# Index a directory (default: sliding window strategy)
npx tsx src/cli.ts index .

# Index with specific strategy
npx tsx src/cli.ts index . --strategy paragraph
npx tsx src/cli.ts index . --strategy sentence
npx tsx src/cli.ts index . --strategy sliding --window 500 --overlap 150

# Search documents
npx tsx src/cli.ts search "budget concerns"

# Search with filters
npx tsx src/cli.ts search "love" --collection "jane austin"
npx tsx src/cli.ts search "meeting notes" --type report
npx tsx src/cli.ts search "quarterly review" --after 2024-01-01 --before 2024-04-01

# View discovered taxonomy
npx tsx src/cli.ts taxonomy .


...