hybrid-search-implementation

Combine vector similarity with keyword matching for hybrid retrieval.

1|Updated Dec 23, 2025
One-click install
npx skills add https://github.com/ccf/claude-code-ccf-marketplace --skill hybrid-search-implementation-ccf
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hybrid-search-implementation
Source: https://github.com/ccf/claude-code-ccf-marketplace/tree/main/plugins/llm-application-dev/skills/hybrid-search-implementation
Command: npx skills add https://github.com/ccf/claude-code-ccf-marketplace --skill hybrid-search-implementation-ccf

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Hybrid search combines vector similarity with keyword matching to improve recall and precision in retrieval tasks, especially for RAG and knowledge-enabled applications.

Core Features & Use Cases

  • Hybrid scoring: balance semantic signals with exact-term matches to improve results in knowledge bases and search systems.
  • Use Cases: Deploy in RAG pipelines, document search, code search, and domain-specific retrieval where pure vector or keyword approaches fall short.
  • Use Case Example: Build a code search tool that returns functionally similar code snippets and exact API name matches for a given query.

Quick Start

Instantiate the hybrid search pipeline with a vector store and a keyword store. Provide a query and its embedding, then run the fusion to return top results. Validate results and adjust fusion parameters as needed.

Frequently Asked Questions about hybrid-search-implementation

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

FAQPage Schema
What is hybrid search and when do I need it for information retrieval?

Hybrid search is a retrieval method that combines vector similarity with keyword matching. You need it for RAG systems and domain-specific search where both semantic understanding and exact term matching are required for sharper recall.

How do I implement hybrid search for a RAG pipeline?

To implement hybrid search, instantiate a pipeline with a vector store and a keyword index. Provide a query and its embedding, run the fusion to return top results, validate the output, and adjust the fusion scoring parameters as needed.

Does hybrid search work for code search and exact API name matching?

Yes, hybrid search works for code search by returning functionally similar code snippets through vector similarity and exact API name matches through keyword indexing, balancing both signals for precise retrieval.

What's the best way to balance vector and keyword search scores?

The best way to balance vector and keyword search scores is to apply a fusion strategy with adjustable scoring parameters. Validate the returned top results and tune the parameters until the semantic and exact-term signals are properly weighted.

What are the limitations of using only vector search or keyword search?

Pure vector search lacks exact term matching precision, while pure keyword search misses semantic understanding. Hybrid search solves this limitation by fusing both signals to improve recall and precision in knowledge bases and search systems.

Do I need a separate vector store and keyword index to run hybrid search?

Yes, you need integration of both a vector store and a keyword index to run hybrid search. These components store the embeddings and exact terms, allowing the fusion strategy to combine their scores for final retrieval.