Skip to main content
skill GitHub Copilot official · GitHub

qdrant-search-quality — GitHub Copilot skill for Qdrant search

Diagnoses why Qdrant returns irrelevant matches and points to ways to improve search quality. Useful after an embedding model change or as your data grows.

Install into GitHub Copilot · Skills CLI (Vercel) All methods and platforms ↓
npx skills add github/awesome-copilot --skill qdrant-search-quality
Open on GitHub

What qdrant-search-quality does

The skill helps distinguish issues with the embedding model or data from Qdrant configuration and query strategy. It starts with exact search as a way to isolate the problem, then checks how text chunks are passed to Qdrant. Splitting text mid-sentence can reduce search quality by 30-40%.

Its guidance covers HNSW tuning, embedding model selection, hybrid search, reranking, and relevance feedback. The available tools are Read, Grep, and Glob. Install it when you need to troubleshoot Qdrant results; it is not aimed at search systems outside Qdrant.

What it helps with

  • trace irrelevant Qdrant results to their source
  • check whether text chunking hurts search quality
  • choose between hybrid search and reranking
  • tune HNSW settings and embedding models

Example prompts for the agent

  • Find out why my Qdrant search returns irrelevant results.
  • Compare exact search with the current strategy and check how text is chunked.
  • Should I add hybrid search or reranking to this Qdrant setup?

How to install qdrant-search-quality

1Skills CLI (Vercel)

npx skills add github/awesome-copilot --skill qdrant-search-quality

2GitHub CLI

gh skill install github/awesome-copilot qdrant-search-quality

3Manually: put the files in place

.github/skills/qdrant-search-quality/SKILL.md

From the same set554

The whole set →
git-commit official github This skill reviews Git changes, stages related files, and creates Conventional Commits. Use it when you want an agent to make one commit or split work into separate commits. GitHub Copilot 47,165installs excalidraw-diagram-generator official github Turn a plain-language description into an Excalidraw diagram. Useful for mapping processes, system structure, and relationships between entities. GitHub Copilot 31,639installs multi-stage-dockerfile official github This skill guides GitHub Copilot in writing multi-stage Dockerfiles for different languages and frameworks. Use it when the final runtime image should contain fewer build dependencies. GitHub Copilot 29,688installs documentation-writer official github Skill that turns the agent into a technical writer following the Diátaxis framework: tutorials, how-to guides, reference, and explanation. Proposes structure before writing. GitHub Copilot 27,757installs prd official github Turns a feature idea into a structured PRD with user stories, technical requirements, and risks. Use it when planning a software feature or an AI-powered one. GitHub Copilot 24,035installs refactor official github This skill reshapes existing code without changing its external behavior. Use it for gradual cleanup of large functions, duplication, weak types, and code smells. GitHub Copilot 22,321installs java-springboot official github Gives GitHub Copilot Spring Boot development practices, from project layout to tests and security. Use it when writing or reviewing Java application code. GitHub Copilot 21,272installs create-readme official github This skill reviews a project and creates a structured README.md. Use it when the repository needs clear documentation based on its actual files and code. GitHub Copilot 19,081installs

Similar

Questions about qdrant-search-quality

How do I install qdrant-search-quality for GitHub Copilot?

Run npx skills add github/awesome-copilot --skill qdrant-search-quality or gh skill install github/awesome-copilot qdrant-search-quality.

What does qdrant-search-quality do?

It helps diagnose Qdrant search relevance by examining the embedding model, data, configuration, and query strategy, then suggests areas to tune.

How can I tell whether Qdrant configuration is causing poor results?

The skill recommends starting with exact search to separate configuration issues from problems with the model, data, or query strategy.

Source text

SKILL.md · MIT
---
name: qdrant-search-quality
description: "Diagnoses and improves Qdrant search relevance. Use when someone reports 'search results are bad', 'wrong results', 'low precision', 'low recall', 'irrelevant matches', 'missing expected results', or asks 'how to improve search quality?', 'which embedding model?', 'should I use hybrid search?', 'should I use reranking?'. Also use when search quality degrades after quantization, model change, or data growth."
allowed-tools:
  - Read
  - Grep
  - Glob
---

# Qdrant Search Quality

First determine whether the problem is the embedding model, Qdrant configuration, or the query strategy. Most quality issues come from the model or data, not from Qdrant itself. If search quality is low, inspect how chunks are being passed to Qdrant before tuning any parameters. Splitting mid-sentence can drop quality 30-40%.

- Start by testing with exact search to isolate the problem [Search API](https://search.qdrant.tech/md/documentation/search/search/?s=search-api)


## Diagnosis and Tuning

Isolate the source of quality issues, tune HNSW parameters, and choose the right embedding model. [Diagnosis and Tuning](diagnosis/SKILL.md)


## Search Strategies

Hybrid search, reranking, relevance feedback, and exploration APIs for improving result quality. [Search Strategies](search-strategies/SKILL.md)

© github · MIT · github/awesome-copilot

See also

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor