RAG Implementation
wshobson/agents
Build retrieval-augmented generation systems: pick a vector database and embedding model, choose retrieval and reranking strategies, and start from a LangGraph pipeline.
Diagnoses and improves Qdrant search relevance. An agent skill from qdrant/skills.
Install Qdrant Search Quality
$ npx skills add qdrant/skills --skill qdrant-search-quality -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install qdrant/skills qdrant-search-quality --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/qdrant/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/qdrant-search-quality .claude/skills/qdrant-search-quality && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "qdrant-search-quality" agent skill from https://github.com/qdrant/skills/tree/main/skills/qdrant-search-quality into .claude/skills/qdrant-search-quality/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "qdrant-search-quality", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/qdrant/skills/tree/main/skills/qdrant-search-qualityType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add qdrant/skills --skill qdrant-search-quality -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install qdrant/skills qdrant-search-quality --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/qdrant/skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/qdrant-search-quality .agents/skills/qdrant-search-quality && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "qdrant-search-quality" agent skill from https://github.com/qdrant/skills/tree/main/skills/qdrant-search-quality into .agents/skills/qdrant-search-quality/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "qdrant-search-quality", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add qdrant/skills --skill qdrant-search-quality -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install qdrant/skills qdrant-search-quality --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/qdrant/skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/qdrant-search-quality .cursor/skills/qdrant-search-quality && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "qdrant-search-quality" agent skill from https://github.com/qdrant/skills/tree/main/skills/qdrant-search-quality into .cursor/skills/qdrant-search-quality/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "qdrant-search-quality", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/qdrant/skills.git --path skills/qdrant-search-quality--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add qdrant/skills --skill qdrant-search-quality -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install qdrant/skills qdrant-search-quality --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/qdrant/skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/qdrant-search-quality .gemini/skills/qdrant-search-quality && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "qdrant-search-quality" agent skill from https://github.com/qdrant/skills/tree/main/skills/qdrant-search-quality into .gemini/skills/qdrant-search-quality/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "qdrant-search-quality", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install qdrant/skills qdrant-search-qualityInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add qdrant/skills --skill qdrant-search-quality -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/qdrant/skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/qdrant-search-quality .github/skills/qdrant-search-quality && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "qdrant-search-quality" agent skill from https://github.com/qdrant/skills/tree/main/skills/qdrant-search-quality into .github/skills/qdrant-search-quality/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "qdrant-search-quality", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add qdrant/skills --skill qdrant-search-quality -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install qdrant/skills qdrant-search-quality --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/qdrant/skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/qdrant-search-quality .opencode/skills/qdrant-search-quality && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "qdrant-search-quality" agent skill from https://github.com/qdrant/skills/tree/main/skills/qdrant-search-quality into .opencode/skills/qdrant-search-quality/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "qdrant-search-quality", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
qdrant-search-quality- GitHub stars
- 254
- Token cost
- ~616 tokens
- SKILL.md length
- 199 words
- Files
- 1
- Skills in repo
- 33
- Repo updated
- First seen
- Licence
- Apache-2.0
At a glance
Diagnoses and improves Qdrant search relevance. An agent skill from qdrant/skills.
- Someone reports search results are bad
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
- Irrelevant matches
- Missing expected results
What it does
Qdrant Search Quality is an agent skill from qdrant/skills, published by the product's own GitHub organization. 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?', 'how to combine keyword and vector search / fusion / RRF / prefetch?', 'should I use reranking?', 'relevance feedback?', 'how to measure retrieval quality?', 'build a golden set', 'ground truth dataset', 'how to score…
Its SKILL.md is about 620 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It sits in AI & LLM Engineering, covering Vector databases, Retrieval-augmented generation and Embeddings. It works with Qdrant. The repository describes itself as: Agent skills for Qdrant vector search: scaling, performance optimization, search quality, monitoring, deployment, model migration, version upgrades, and SDK usage across Python…. The licence is Apache-2.0.
When your agent uses it
- Someone reports search results are bad
- Irrelevant matches
- Missing expected results
- Asks how to improve search quality?
Example prompts
- “search results are bad”
- “wrong results”
- “low precision”
- “/qdrant-search-quality”
Requirements
- Pre-approved tools (allowed-tools): Read, Grep, Glob
What it can do on your machine
Read from SKILL.md and the folder at commit 57658ea. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves these tools, so the agent can use them without asking each time:
ReadGrepGlob
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md.
From the folder's file list and the shell code blocks in SKILL.md.
Network
Links to these hosts (documentation or services it may open):
skills.qdrant.tech
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Qdrant Search Quality loads about 616 tokens when it runs. Until then it costs about 184 tokens; SKILL.md has 199 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from qdrant/skills at commit 57658ea, republished under its Apache-2.0 licence (© qdrant). 199 words, ~616 tokens.
Download SKILL.mdSave it as
.claude/skills/qdrant-search-quality/SKILL.md (or your agent's skills folder).- 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?', 'how to combine keyword and vector search / fusion / RRF / prefetch?', 'should I use reranking?', 'relevance feedback?', 'how to measure retrieval quality?', 'build a golden set', 'ground truth dataset', 'how to score recall@k?', 'is my improvement real / statistically significant?', or 'should I fine-tune my embedding model?'. Also use when search quality degrades after quantization, model change, or data growth.
- allowed-tools
- Read, Grep, Glob
Qdrant Search Quality
Route first, then answer. Match the user's symptom in the table, Read that file, and answer from it.
Do not answer from this page alone: it contains routing only, not the guidance. If two rows match, read both.
| The user says | Read |
|---|---|
| Search results are bad or irrelevant, wrong results, missing expected matches | diagnosis/SKILL.md |
| Low recall, expected results are missing | diagnosis/SKILL.md |
| Low precision, too many wrong matches | diagnosis/SKILL.md |
| Which embedding model to use, quality dropped after quantization, model change, or data growth | diagnosis/SKILL.md |
| Not sure if the model, the data, or Qdrant is at fault | diagnosis/SKILL.md |
| Want to measure recall, build a golden set, ground truth dataset, recall@k | diagnosis/SKILL.md |
| Is my improvement real, statistically significant, fine-tune the embedding model | diagnosis/SKILL.md |
| Need to combine keyword and semantic search, hybrid search, sparse + dense, fusion / RRF, prefetch | search-strategies/hybrid-search/SKILL.md |
| Should I rerank, results too similar, need diversity, MMR, recommendation/discovery API | search-strategies/SKILL.md |
| Improving results with relevance feedback or user clicks, cheaper alternative to reranking | search-strategies/relevance-feedback/SKILL.md |
Most quality issues come from the embedding model or the data, not from Qdrant's configuration — splitting chunks mid-sentence alone can drop quality 30-40%. Rule that out with exact search before tuning any Qdrant parameter: Search API
© qdrant, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
Just SKILL.md in skills/qdrant-search-quality of qdrant/skills.
Open the folder on GitHubat commit 57658ea
Compare with similar skills
Qdrant Search Quality next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Qdrant Search Quality this skillqdrant/skills | 254 | — | ~616 | Automated safety check: Pass | Apache-2.0 | |
| RAG Implementationwshobson/agents | 40k | 9 repos | ~1.1k | Automated safety check: Pass | MIT | |
| Hunt RAG Vectorelementalsouls/Claude-BugHunter | 4.8k | — | ~2.6k | Automated safety check: Pass | MIT | |
| Qdrant Search Qualitygithub/awesome-copilot | 40k | 1 repos | ~336 | Automated safety check: Pass | MIT | |
| RAG ArchitectJeffallan/claude-skills | 12k | — | ~2k | Automated safety check: Pass | MIT | |
| RAG Patternssoftspark/ai-toolkit | 179 | — | ~1.8k | Automated safety check: Pass | Apache-2.0 |
Similar skills
Hunt RAG Vector
elementalsouls/Claude-BugHunter
Hunt vector-store / embedding-layer weaknesses in RAG pipelines (OWASP LLM08 Vector and Embedding Weaknesses) — persistent corpus poisoning that survives across sessions and users (distinct from…
- Official
Qdrant Search Quality
github/awesome-copilot
Diagnoses and improves Qdrant search relevance. An agent skill from github/awesome-copilot.
RAG Architect
Jeffallan/claude-skills
Designs retrieval-augmented generation systems: document chunking, embeddings, vector store setup, hybrid search, reranking and retrieval evaluation, with checks at each step.
RAG Patterns
softspark/ai-toolkit
RAG: embeddings, chunking, hybrid search (BM25+vector), reranking, CRAG, multi-hop.
Chroma Vector Database
Orchestra-Research/AI-Research-SKILLs
Shows how to store documents and embeddings in Chroma, query them by similarity with metadata filters, and persist them to disk for RAG and semantic search projects.
More from qdrant/skills
All 33 skills in this repo- Official
Qdrant Clients SDK
qdrant/skills
Qdrant provides client SDKs for various programming languages, allowing easy integration with Qdrant deployments.
- Official
Qdrant Advisor
qdrant/skills
Diagnose, troubleshoot, and advise on any Qdrant deployment by loading the latest official Qdrant skills live from skills.qdrant.tech.
- Official
Qdrant Deployment Options
qdrant/skills
Guides Qdrant deployment selection. An agent skill from qdrant/skills.
- Official
Qdrant Search Strategies
qdrant/skills
Guides Qdrant search strategy selection. An agent skill from qdrant/skills.
- Official
Qdrant Horizontal Scaling
qdrant/skills
Diagnoses and guides Qdrant horizontal scaling decisions. An agent skill from qdrant/skills.
- Official
Qdrant Indexing Performance Optimization
qdrant/skills
Diagnoses and fixes slow Qdrant indexing and data ingestion.
Related
Works with
Categories
Questions about Qdrant Search Quality
What does Qdrant Search Quality do?
Diagnoses and improves Qdrant search relevance. An agent skill from qdrant/skills. Qdrant Search Quality is an agent skill from qdrant/skills, published by the product's own GitHub organization. Diagnoses and improves Qdrant search relevance.
When should I use Qdrant Search Quality?
Qdrant Search Quality fits situations like: someone reports search results are bad; irrelevant matches; missing expected results; asks how to improve search quality?.
How do I install Qdrant Search Quality in Claude Code?
Run `npx skills add qdrant/skills --skill qdrant-search-quality -a claude-code`. Or copy the skill folder (skills/qdrant-search-quality in qdrant/skills) into .claude/skills/qdrant-search-quality in your project. Claude Code loads it when a task matches its description.
How do I install Qdrant Search Quality in Codex?
Run `npx skills add qdrant/skills --skill qdrant-search-quality -a codex`. Or copy the skill folder (skills/qdrant-search-quality in qdrant/skills) into .agents/skills/qdrant-search-quality in your project. Codex loads it when a task matches its description.
Can I use Qdrant Search Quality in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add qdrant/skills --skill qdrant-search-quality -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/qdrant-search-quality, .gemini/skills/qdrant-search-quality, .github/skills/qdrant-search-quality and .opencode/skills/qdrant-search-quality in your project.
What does Qdrant Search Quality need to run?
SKILL.md names no scripts, command-line tools or credentials: Qdrant Search Quality is instructions for the agent only. Its frontmatter pre-approves these tools: Read, Grep, Glob.
Does Qdrant Search Quality access the network?
SKILL.md names 1 domain. As links in the text: skills.qdrant.tech. This is read from the text; nothing was executed.
Is Qdrant Search Quality safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Qdrant Search Quality use?
Qdrant Search Quality is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Qdrant Search Quality use?
About 616 tokens (SKILL.md is roughly 2.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Qdrant Search Quality?
Skills that share tags, products or a category with Qdrant Search Quality: RAG Implementation (wshobson/agents, 40k stars), Hunt RAG Vector (elementalsouls/Claude-BugHunter, 4.8k stars), Qdrant Search Quality (github/awesome-copilot, 40k stars) and RAG Architect (Jeffallan/claude-skills, 12k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Qdrant Search Quality?
qdrant (a GitHub organization, an official publisher) maintains it in qdrant/skills, which has 254 GitHub stars. The repository holds 33 skills in this directory. The repository was last updated on October 8, 2026.
Source: qdrant/skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.