Claude Cursor Skill

hybrid-search-implementation

Combine vector and keyword search for improved retrieval. Use when implementing RAG systems, building search engines, or when neither approach alone provides sufficient recall.

LLM Mart · 0 points · 10 views 0 listing impressions 0 install-command copies
Download wshobson-agents-plugins_llm-application-dev_skills_hybrid-search-implementation-554237f.zip · 5 KB

Install

skills CLI npx skills add https://github.com/wshobson/agents/tree/main/plugins/llm-application-dev/skills/hybrid-search-implementation
Claude Code claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install wshobson-agents@llmmart
Git git clone https://github.com/wshobson/agents.git

The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole wshobson/agents collection as a plugin from our marketplace. Git is the plain clone.

Skill manifest

Hybrid Search Implementation

Patterns for combining vector similarity and keyword-based search.

When to Use This Skill

  • Building RAG systems with improved recall
  • Combining semantic understanding with exact matching
  • Handling queries with specific terms (names, codes)
  • Improving search for domain-specific vocabulary
  • When pure vector search misses keyword matches

Core Concepts

1. Hybrid Search Architecture

Query → ┬─► Vector Search ──► Candidates ─┐
        │                                  │
        └─► Keyword Search ─► Candidates ─┴─► Fusion ─► Results

2. Fusion Methods

Method Description Best For
RRF Reciprocal Rank Fusion General purpose
Linear Weighted sum of scores Tunable balance
Cross-encoder Rerank with neural model Highest quality
Cascade Filter then rerank Efficiency

Templates and detailed worked examples

Full template library and detailed worked examples live in references/details.md. Read that file when you need the concrete templates.

Best Practices

Do's

  • Tune weights empirically - Test on your data
  • Use RRF for simplicity - Works well without tuning
  • Add reranking - Significant quality improvement
  • Log both scores - Helps with debugging
  • A/B test - Measure real user impact

Don'ts

  • Don't assume one size fits all - Different queries need different weights
  • Don't skip keyword search - Handles exact matches better
  • Don't over-fetch - Balance recall vs latency
  • Don't ignore edge cases - Empty results, single word queries
Files (agents)
  • references
    • details.md 15.8 KB
      Loading…
  • SKILL.md 2 KB
    ---
    name: hybrid-search-implementation
    description: Combine vector and keyword search for improved retrieval. Use when implementing RAG systems, building search engines, or when neither approach alone provides sufficient recall.
    ---
    
    # Hybrid Search Implementation
    
    Patterns for combining vector similarity and keyword-based search.
    
    ## When to Use This Skill
    
    - Building RAG systems with improved recall
    - Combining semantic understanding with exact matching
    - Handling queries with specific terms (names, codes)
    - Improving search for domain-specific vocabulary
    - When pure vector search misses keyword matches
    
    ## Core Concepts
    
    ### 1. Hybrid Search Architecture
    
    ```
    Query → ┬─► Vector Search ──► Candidates ─┐
            │                                  │
            └─► Keyword Search ─► Candidates ─┴─► Fusion ─► Results
    ```
    
    ### 2. Fusion Methods
    
    | Method            | Description              | Best For        |
    | ----------------- | ------------------------ | --------------- |
    | **RRF**           | Reciprocal Rank Fusion   | General purpose |
    | **Linear**        | Weighted sum of scores   | Tunable balance |
    | **Cross-encoder** | Rerank with neural model | Highest quality |
    | **Cascade**       | Filter then rerank       | Efficiency      |
    
    ## Templates and detailed worked examples
    
    Full template library and detailed worked examples live in `references/details.md`. Read that file when you need the concrete templates.
    
    ## Best Practices
    
    ### Do's
    
    - **Tune weights empirically** - Test on your data
    - **Use RRF for simplicity** - Works well without tuning
    - **Add reranking** - Significant quality improvement
    - **Log both scores** - Helps with debugging
    - **A/B test** - Measure real user impact
    
    ### Don'ts
    
    - **Don't assume one size fits all** - Different queries need different weights
    - **Don't skip keyword search** - Handles exact matches better
    - **Don't over-fetch** - Balance recall vs latency
    - **Don't ignore edge cases** - Empty results, single word queries
    

Comments (0)

Sign in to join the conversation.

No comments yet.

Reviews (0)

No reviews yet.