# Qdrant search quality diagnosis

> Qdrant search quality diagnosis is an open-source agent skill for knowledge and memory. Diagnoses Qdrant search quality issues. It is available on Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, Windsurf and Goose.

- **Kind:** Skill
- **Pricing:** Open source
- **Platforms:** Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, Windsurf, Goose
- **Website:** https://github.com/qdrant/skills/tree/main/skills/qdrant-search-quality/diagnosis
- **Repository:** https://github.com/qdrant/skills
- **GitHub stars:** 269
- **License:** Apache-2.0
- **Skill name:** qdrant-search-quality-diagnosis
- **Collection:** https://github.com/qdrant/skills
- **Categories:** knowledge and memory
- **Listing updated:** 2026-11-17

## About

Diagnoses Qdrant search quality issues. Use when someone reports 'results are bad', 'wrong results', 'not relevant results', 'missing matches', 'recall is low', 'approximate search worse than exact', 'which embedding model', 'should I fine-tune my embedding model', 'quality dropped after quantization', 'how to measure retrieval quality', 'build a golden set', 'ground truth dataset', 'how to score recall@k', or 'is my improvement real / statistically significant'. Also use when search quality degrades without obvious changes.

## When your agent uses it

> Diagnoses Qdrant search quality issues. Use when someone reports 'results are bad', 'wrong results', 'not relevant results', 'missing matches', 'recall is low', 'approximate search worse than exact', 'which embedding model', 'should I fine-tune my embedding model', 'quality dropped after quantization', 'how to measure retrieval quality', 'build a golden set', 'ground truth dataset', 'how to score recall@k', or 'is my improvement real / statistically significant'. Also use when search quality degrades without obvious changes.

## What it can access

From a static check of the files on GitHub; nothing was run.

- [Instructions only, no scripts](https://github.com/qdrant/skills/tree/HEAD/skills/qdrant-search-quality/diagnosis)
- [License: Apache-2.0](https://github.com/qdrant/skills/tree/HEAD/skills/qdrant-search-quality/diagnosis)

## Install

### Claude Code

This skill ships in the `qdrant` plugin. In Claude Code, add the marketplace and install the plugin (it may include other skills too):

```sh
/plugin marketplace add qdrant/skills
/plugin install qdrant@qdrant
```

Or copy only this skill to `~/.claude/skills/qdrant-search-quality-diagnosis`:

```sh
tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/qdrant/skills.git "$tmp" &&
mkdir -p ~/.claude/skills &&
rm -rf ~/.claude/skills/qdrant-search-quality-diagnosis &&
cp -R "$tmp/skills/qdrant-search-quality/diagnosis" ~/.claude/skills/qdrant-search-quality-diagnosis &&
rm -rf "$tmp"
```

For one project only, put the folder in `.claude/skills/qdrant-search-quality-diagnosis` inside it instead.

### Codex

Copy the skill folder to `~/.agents/skills/qdrant-search-quality-diagnosis` to use it in every repository:

```sh
tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/qdrant/skills.git "$tmp" &&
mkdir -p ~/.agents/skills &&
rm -rf ~/.agents/skills/qdrant-search-quality-diagnosis &&
cp -R "$tmp/skills/qdrant-search-quality/diagnosis" ~/.agents/skills/qdrant-search-quality-diagnosis &&
rm -rf "$tmp"
```

For one repository only, put the folder in `.agents/skills/qdrant-search-quality-diagnosis` inside it instead.

### Cursor

Copy the skill folder to `~/.cursor/skills/qdrant-search-quality-diagnosis` to use it in every project:

```sh
tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/qdrant/skills.git "$tmp" &&
mkdir -p ~/.cursor/skills &&
rm -rf ~/.cursor/skills/qdrant-search-quality-diagnosis &&
cp -R "$tmp/skills/qdrant-search-quality/diagnosis" ~/.cursor/skills/qdrant-search-quality-diagnosis &&
rm -rf "$tmp"
```

For one project only, put the folder in `.cursor/skills/qdrant-search-quality-diagnosis` inside it instead.

### Gemini CLI

Run in a terminal (add `--scope workspace` to install it for the current workspace only):

```sh
gemini skills install https://github.com/qdrant/skills.git --path skills/qdrant-search-quality/diagnosis
```

Or copy the folder to `~/.gemini/skills/qdrant-search-quality-diagnosis` yourself.

### VS Code

For GitHub Copilot in VS Code, copy the skill folder to `~/.copilot/skills/qdrant-search-quality-diagnosis`:

```sh
tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/qdrant/skills.git "$tmp" &&
mkdir -p ~/.copilot/skills &&
rm -rf ~/.copilot/skills/qdrant-search-quality-diagnosis &&
cp -R "$tmp/skills/qdrant-search-quality/diagnosis" ~/.copilot/skills/qdrant-search-quality-diagnosis &&
rm -rf "$tmp"
```

For one project only, put the folder in `.github/skills/qdrant-search-quality-diagnosis` inside it instead.

### Other agents

Get the folder:

```sh
git clone --depth 1 https://github.com/qdrant/skills.git
```

Then copy `skills/skills/qdrant-search-quality/diagnosis` into your agent's skills folder as `qdrant-search-quality-diagnosis`. Agents that support SKILL.md read one folder per skill.

## FAQ

### How do I install Qdrant search quality diagnosis in Claude Code?

Copy the skill folder from GitHub to ~/.claude/skills/qdrant-search-quality-diagnosis to use it in all your projects, or to .claude/skills/qdrant-search-quality-diagnosis in one project. Or install the qdrant plugin, which includes it: /plugin marketplace add qdrant/skills, then /plugin install qdrant@qdrant.

### Does Qdrant search quality diagnosis run scripts?

No. It is instructions only, with no scripts. This comes from a static check of the files on GitHub; nothing was run. Read the files before you install it.

### Which AI agents can use Qdrant search quality diagnosis?

Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, Windsurf and Goose. Each reads skills in the SKILL.md format from its own folder; the install steps on this page list them.

### What are the best alternatives to Qdrant search quality diagnosis?

The closest alternatives to Qdrant search quality diagnosis are Claude API, Qdrant horizontal scaling, Pinecone rag, Qdrant memory usage optimization and Qdrant scaling query volume.

## Alternatives

- [Claude API](https://ai-powered.com/skills/claude-api): Claude API is an agent skill for ai models and llm tooling.
- [Qdrant horizontal scaling](https://ai-powered.com/skills/qdrant-horizontal-scaling): Qdrant horizontal scaling is an open-source agent skill for knowledge and memory.
- [Pinecone rag](https://ai-powered.com/skills/pinecone-rag): Pinecone rag is an open-source agent skill for knowledge and memory.
- [Qdrant memory usage optimization](https://ai-powered.com/skills/qdrant-memory-usage-optimization): Qdrant memory usage optimization is an open-source agent skill for knowledge and memory.
- [Qdrant scaling query volume](https://ai-powered.com/skills/qdrant-scaling-query-volume): Qdrant scaling query volume is an open-source agent skill for knowledge and memory.
- [Qdrant search quality diagnosis](https://ai-powered.com/skills/qdrant-search-quality-diagnosis): Qdrant search quality diagnosis is an open-source agent skill for knowledge and memory.
- [Qdrant vertical scaling](https://ai-powered.com/skills/qdrant-vertical-scaling): Qdrant vertical scaling is an open-source agent skill for knowledge and memory.
- [Qdrant monitoring setup](https://ai-powered.com/skills/qdrant-monitoring-setup): Qdrant monitoring setup is an open-source agent skill for knowledge and memory.

---
Source: https://ai-powered.com/skills/qdrant-search-quality-diagnosis-qdrant
