qdrant-search-strategies
About
This skill helps developers select and implement advanced Qdrant search strategies to improve retrieval quality. It provides guidance for scenarios like hybrid search, reranking, diversity (MMR), relevance feedback, and combining keyword with vector search. Use it when basic vector search returns irrelevant, too-similar, or incomplete results from your dataset.
Quick Install
Claude Code
Recommendednpx skills add qdrant/skills -a claude-code/plugin add https://github.com/qdrant/skillsgit clone https://github.com/qdrant/skills.git ~/.claude/skills/qdrant-search-strategiesCopy and paste this command in Claude Code to install this skill
Documentation
How to Improve Search Results with Advanced Strategies
These strategies complement basic vector search. Use them after confirming the embedding model is fitting the task and HNSW config is correct. If exact search returns bad results, verify the selection of the embedding model (retriever) first. If the user wants to use a weaker embedding model because it is small, fast, and cheap, use reranking or relevance feedback to improve search quality.
Missing Keyword Matches or Need to Combine Multiple Search Signals
Use when: pure vector search misses keyword/domain term matches, or the use case benefits from combining searches on multiple representations (including languages and modalities) of the same item.
See how to use hybrid search
Right Documents Found But Not in the Top Results
Use when: good recall but poor precision (right docs in top-100, not top-10).
- See how to use Multistage queries, for example with late interaction rerankers through Multivectors.
- Cross-encoder rerankers via FastEmbed Rerankers
Dense Retriever Misses Relevant Items or Reranking Is Too Costly
Use when: dense retriever misses relevant items you know exist in the collection; relevant documents lie outside the initial ANN retrieval pool; reranking a large candidate pool is too slow or expensive; using a small/cheap embedding model but need quality close to a larger model; or want to improve top-1/3 precision without the full cost of reranking.
See Relevance Feedback in Qdrant
Results Too Similar
Use when: top results are redundant, near-duplicates, or lack diversity. Common in dense content domains (academic papers, product catalogs).
- Use MMR (v1.15+) as a query parameter with
diversityto balance relevance and diversity MMR - Start with
diversity=0.5, lower for more precision, higher for more exploration - MMR is slower than standard search. Only use when redundancy is an actual problem.
Want to improve search results based on examples (positive and negative)
Use when: you can provide positive and negative example points to steer search closer to positive and further from negative.
- Recommendation API: positive/negative examples to recommend fitting vectors Recommendation API
- Best score strategy: better for diverse examples, supports negative-only Best score
- Discovery API: context pairs (positive/negative) to constrain search regions without a request target Discovery
Have Business Logic Behind Results Relevance
Use when: results should be additionally ranked according to some business logic based on data, like recency or distance.
Check how to set up in Score Boosting docs
What NOT to Do
- Use hybrid search before verifying pure vector search quality (adds complexity, may mask model issues)
- Skip evaluation when adding relevance feedback — score the end-to-end pipeline to confirm it actually helps Pipeline Output Quality
GitHub Repository
Related Skills
executing-plans
DesignUse the executing-plans skill when you have a complete implementation plan to execute in controlled batches with review checkpoints. It loads and critically reviews the plan, then executes tasks in small batches (default 3 tasks) while reporting progress between each batch for architect review. This ensures systematic implementation with built-in quality control checkpoints.
requesting-code-review
DesignThis skill dispatches a code-reviewer subagent to analyze code changes against requirements before proceeding. It should be used after completing tasks, implementing major features, or before merging to main. The review helps catch issues early by comparing the current implementation with the original plan.
connect-mcp-server
DesignThis skill provides a comprehensive guide for developers to connect MCP servers to Claude Code using HTTP, stdio, or SSE transports. It covers installation, configuration, authentication, and security for integrating external services like GitHub, Notion, and custom APIs. Use it when setting up MCP integrations, configuring external tools, or working with Claude's Model Context Protocol.
web-cli-teleport
DesignThis skill helps developers choose between Claude Code Web and CLI interfaces based on task analysis, then enables seamless session teleportation between these environments. It optimizes workflow by managing session state and context when switching between web, CLI, or mobile. Use it for complex projects requiring different tools at various stages.
