hybrid-search-rrf

Merge full-text and vector search results using Reciprocal Rank Fusion.

7|Updated Dec 4, 2025
One-click install
npx skills add https://github.com/planetaryescape/blah.chat --skill hybrid-search-rrf
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hybrid-search-rrf
Source: https://github.com/planetaryescape/blah.chat/tree/main/.claude/skills/hybrid-search-rrf
Command: npx skills add https://github.com/planetaryescape/blah.chat --skill hybrid-search-rrf

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill enables pulling more relevant results by merging traditional full-text search with vector-based semantic search using Reciprocal Rank Fusion (RRF). It improves result quality by reconciling exact keyword matches with semantic similarity, while providing admin controls to enable or disable the hybrid workflow.

Core Features & Use Cases

  • Hybrid search combines keyword and embedding-based results to boost relevance for diverse queries.
  • RRF merging aggregates rankings with adjustable weight and handles overlapping results for stronger final rankings.
  • Admin control supports toggling hybrid search to fall back to text-only results when needed.

Quick Start

Use the hybrid-search-rrf skill to merge text and vector results for a given query.

Frequently Asked Questions about hybrid-search-rrf

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

FAQPage Schema
How does Reciprocal Rank Fusion improve hybrid search results?

Reciprocal Rank Fusion (RRF) improves hybrid search by aggregating full-text and vector search rankings into a unified score. It reconciles exact keyword matches with semantic similarity, handling overlapping results to produce stronger final rankings.

How do I merge full-text and vector search results in Convex?

You can merge full-text and vector search results in Convex by applying Reciprocal Rank Fusion. This approach combines searchIndex and vectorIndex outputs, reconciling exact keyword matches with semantic similarity for improved retrieval quality.

Can I configure hybrid search weights for keyword and vector results?

Yes, hybrid search supports adjustable weight configuration for RRF merging. This allows you to tune the influence of full-text versus vector rankings when aggregating overlapping results into the final relevance score.

Does hybrid search work with both Convex searchIndex and vectorIndex?

Hybrid search works with both Convex searchIndex and vectorIndex. It pulls results from both indexes and merges them using Reciprocal Rank Fusion to boost relevance across traditional keyword and semantic vector queries.

What happens if I need to disable vector search and fall back to text-only results?

An admin toggle allows you to disable hybrid search and fall back to text-only results. This provides a necessary fallback path when vector search is not needed or encounters issues.

When should I use hybrid search instead of vector search alone?

Use hybrid search instead of vector search alone when queries benefit from both exact keyword matches and semantic similarity. RRF merging boosts relevance for diverse queries that rely on both precise terms and contextual meaning.