qdrant/qdrant-hybrid-search-combining
Fusing scores from multiple searches into a single ranked result (RRF, DBSF, custom fusion). Use when someone asks 'RRF or DBSF?', 'how to combine sparse and dense', 'how to combine scores from multiple searches?', 'custom fusion', or 'fusion is not producing good results
npx skills add https://github.com/qdrant/skills --skill qdrant-hybrid-search-combining
The outer query fuses ranked candidate lists from all parallel prefetches into one ranked list of results. Fusion methods differ in whether they use rank, score or directly vector representations of candidates (their similarity to the outer query) and whether final score incorporates payload metadata. All methods support flat (one fusion step) and nested (multi-stage) prefetch structures.
Use when: searches produce scores on different scales, like BM25 and cosine on dense embeddings.
k to control rank sensitivity in RRF fusion.Use when: recency, popularity or other payload values should affect the merged ranking alongside candidate scores or you need a custom fusion.
With formula query, access score of each prefetch and, if desired, payload field values.
If you want to implement custom fusion on score of each prefetch:
When using FormulaQuery over multiple prefetches (e.g. per-representation weighting):
$score[i] indexes prefetches in declaration order. Reordering the prefetch= list silently shifts which weight applies to which retriever.defaults for every $score[i] so the formula still evaluates for candidates that surfaced from only a subset of prefetches.FormulaQuery only when explicit per-representation weighting or payload-driven boosts are required, and normalize each $score[i] (decay or min-max on a sampled distribution) before combining linearly.Use when: you want to use similarity between query and candidates' vector representations as the prefetches combiner and simultaneously ranker.
More resource heavy than score/rank based fusions, but might be necessary due to use case requirements or need in a high top-K precision of results (when parallel prefetches have overall a good recall of retrieved candidates).
You can use any type of vector as an outer query over the prefetches, to perform the fusion on the server-side in one QueryAPI request: sparse, dense, multivector. For that, same type of vector representations for documents need to be stored as named vectors per point.
Instead of using client-side fusion through cross-encoders, a popular option is Late interaction models-based fusion, through reranking on multivectors (e.g. ColBERT for text, ColPali and ColQwen for images).
Take qdrant/qdrant-hybrid-search-combining from the repository into ~/.claude/skills for personal
use, or into .claude/skills inside a project.
The agent identifies a skill by the name field in its header. Two skills with the
same name cannot sit side by side — one of them will be ignored.