Official agent skill

Qdrant Search Speed Optimization

by qdrant in qdrant/skills

Diagnoses and fixes slow Qdrant search. An agent skill from qdrant/skills.

OfficialApache-2.0Auto-check passedDatabases

Install Qdrant Search Speed Optimization

skills CLI
$ npx skills add qdrant/skills --skill qdrant-search-speed-optimization -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install qdrant/skills qdrant-search-speed-optimization --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/qdrant/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/qdrant-performance-optimization/search-speed-optimization .claude/skills/qdrant-search-speed-optimization && rm -rf skills-src

Use ~/.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/

Facts

Skill name
qdrant-search-speed-optimization
GitHub stars
253
Used in
2 other repos
Token cost
~1.2k tokens
SKILL.md length
470 words
Files
1
Skills in repo
33
Repo updated
First seen
Licence
Apache-2.0

At a glance

Diagnoses and fixes slow Qdrant search. An agent skill from qdrant/skills.

  • Someone reports search is slow
  • SKILL.md covers Single Query Too Slow (Latency), Can't Handle Enough QPS…, Filtered Search Is Slow and Optimize search performance…, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Queries take too long

What it does

Qdrant Search Speed Optimization is an agent skill from qdrant/skills, published by the product's own GitHub organization. Diagnoses and fixes slow Qdrant search. Use when someone reports 'search is slow', 'high latency', 'queries take too long', 'low QPS', 'throughput too low', 'filtered search is slow', or 'search was fast but now it's slow'. Also use when search performance degrades after config changes or data growth.

Its SKILL.md is about 1.2k 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 Databases, covering Vector databases. 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 is slow
  • Queries take too long
  • Throughput too low
  • Filtered search is slow

Example prompts

  • “search is slow”
  • “high latency”
  • “queries take too long”
  • “/qdrant-search-speed-optimization”

What it can do on your machine

Read from SKILL.md and the folder at commit 476a18d. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    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 Speed Optimization loads about 1.2k tokens when it runs. Until then it costs about 84 tokens; SKILL.md has 470 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~84
When it runs · the whole SKILL.md, loaded when a task matches
~1.2k

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 476a18d, republished under its Apache-2.0 licence (© qdrant). 470 words, ~1,231 tokens.

Download SKILL.mdSave it as .claude/skills/qdrant-search-speed-optimization/SKILL.md (or your agent's skills folder).
name
qdrant-search-speed-optimization
description
Diagnoses and fixes slow Qdrant search. Use when someone reports 'search is slow', 'high latency', 'queries take too long', 'low QPS', 'throughput too low', 'filtered search is slow', or 'search was fast but now it's slow'. Also use when search performance degrades after config changes or data growth.

Diagnose a problem

There the multiple possible reasons for search performance degradation. The most common ones are:

  • Memory pressure: if the working set exceeds available RAM
  • Complex requests (e.g. high hnsw_ef, complex filters without payload index)
  • Competing background processes (e.g. optimizer still running after bulk upload)
  • Problem with the cluster (e.g. network issues, hardware degradation)

Single Query Too Slow (Latency)

Use when: individual queries take too long regardless of load.

Diagnostic steps:
  • Check if second run of the same request is significantly faster (indicates memory pressure)
  • Try the same query with with_payload: false and with_vectors: false to see if payload retrieval is the bottleneck
  • If request uses filters, try to remove them one by one to identify if a specific filter condition is the bottleneck
Common fixes:

Can't Handle Enough QPS (Throughput)

Use when: system can't serve enough queries per second under load.

Filtered Search Is Slow

Use when: filtered search is significantly slower than unfiltered. Most common SA complaint after memory.

  • Create payload index on the filtered field Payload index
  • Use is_tenant=true for primary filtering condition: Tenant index
  • Try ACORN algorithm for complex filters: ACORN
  • Avoid using nested filtering conditions as a primary filter. It might force qdrant to read raw payload values instead of using index.
  • If payload index was added after HNSW build, trigger re-index to create filterable subgraph links
Show full SKILL.md (179 more words)Show less

Optimize search performance with parallel updates

Diagnostic steps
  • Try to run the same query with indexed_only=true parameter, if the query is significantly faster, it means that the optimizer is still running and has not yet indexed all segments.
  • If CPU or IO usage is high even with no queries, it also indicates that the optimizer is still running.
  • reduce optimizer_cpu_budget to reserve more CPU for queries
  • Use prevent_unoptimized=true to prevent creating segments with a large amount of unindexed data for searches. Instead, once a segment reaches the so called indexing_threshold, all additional points will be added in ‘deferred state’.

Learn more here

What NOT to Do

  • Set quantization to not stay in RAM (disk thrashing on every search): avoid memory: cold/cached on Qdrant 1.19 or newer; on 1.18 or older, avoid leaving always_ram false or unset while the original vectors are on_disk: true
  • Put HNSW on disk for latency-sensitive production (only for cold storage)
  • Increase segment count for throughput (opposite: fewer = better)
  • Create payload indexes on every field (wastes memory)
  • Blame Qdrant before checking optimizer status

© 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-performance-optimization/search-speed-optimization of qdrant/skills.

Open the folder on GitHubat commit 476a18d

Used in 2 other repositories

We found 2 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 2 other GitHub owners. This page covers the copy in qdrant/skills, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Qdrant Search Speed Optimization 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.

Qdrant Search Speed Optimization compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Qdrant Search Speed Optimization this skillqdrant/skills2532 repos~1.2kAutomated safety check: PassApache-2.0
Codebase Explorationgiancarloerra/SocratiCode3.3k1 repos~1.5kAutomated safety check: PassAGPL-3.0
Qdrant Vector SearchOrchestra-Research/AI-Research-SKILLs13k5 repos~3.4kAutomated safety check: PassMIT
Using Vector Databasesancoleman/ai-design-components5261 repos~3.5kAutomated safety check: PassMIT
Qdrant Search Strategiesgithub/awesome-copilot40k1 repos~1.7kAutomated safety check: PassMIT
Qdrantgiuseppe-trisciuoglio/developer-kit3551 repos~1.6kAutomated safety check: NotesMIT

Similar skills

  • Codebase Exploration

    giancarloerra/SocratiCode

    Explore and understand codebases using SocratiCode semantic search, dependency graphs, and context artifacts.

    3.3k GitHub starsUsed in 1 repo~1.5k tokens
    DatabasesAuto-check passed
  • Qdrant Vector Search

    Orchestra-Research/AI-Research-SKILLs

    Explains how to run Qdrant, a Rust vector database, for RAG and semantic search, covering collections, points, distance metrics and filtered or batched queries.

    13k GitHub starsUsed in 5 repos~3.4k tokens
    DatabasesAuto-check passed
  • Using Vector Databases

    ancoleman/ai-design-components

    Vector database implementation for AI/ML applications, semantic search, and RAG systems.

    526 GitHub starsUsed in 1 repo~3.5k tokens
    DatabasesAuto-check passed
  • Qdrant Search Strategies

    github/awesome-copilot

    Official

    Guides Qdrant search strategy selection. An agent skill from github/awesome-copilot.

    40k GitHub starsUsed in 1 repo~1.7k tokens
    DatabasesAuto-check passed
  • Qdrant

    giuseppe-trisciuoglio/developer-kit

    Provides Qdrant vector database integration patterns with LangChain4j.

    355 GitHub starsUsed in 1 repo~1.6k tokens
    DatabasesAuto-check: notes
  • Qdrant

    AlexAI-MCP/hermes-CCC

    High-performance vector search engine for production RAG — Rust-powered, horizontal scaling, hybrid dense+sparse search, metadata filtering.

    135 GitHub stars~1.3k tokensUpdated 6 mo ago
    DatabasesAuto-check passed

More from qdrant/skills

All 33 skills in this repo
  • Qdrant Clients SDK

    qdrant/skills

    Official

    Qdrant provides client SDKs for various programming languages, allowing easy integration with Qdrant deployments.

    253 GitHub starsUsed in 2 repos~752 tokens
    Auto-check: notes
  • Qdrant Advisor

    qdrant/skills

    Official

    Diagnose, troubleshoot, and advise on any Qdrant deployment by loading the latest official Qdrant skills live from skills.qdrant.tech.

    253 GitHub stars~1.7k tokensUpdated yesterday
    Auto-check passed
  • Official

    Guides Qdrant deployment selection. An agent skill from qdrant/skills.

    253 GitHub starsUsed in 2 repos~976 tokens
    Auto-check passed
  • Official

    Guides Qdrant search strategy selection. An agent skill from qdrant/skills.

    253 GitHub stars~1.3k tokensUpdated yesterday
    Auto-check passed
  • Official

    Diagnoses and guides Qdrant horizontal scaling decisions. An agent skill from qdrant/skills.

    253 GitHub starsUsed in 2 repos~833 tokens
    Auto-check passed

Works with

Questions about Qdrant Search Speed Optimization

What does Qdrant Search Speed Optimization do?

Diagnoses and fixes slow Qdrant search. An agent skill from qdrant/skills. Qdrant Search Speed Optimization is an agent skill from qdrant/skills, published by the product's own GitHub organization. Diagnoses and fixes slow Qdrant search.

When should I use Qdrant Search Speed Optimization?

Qdrant Search Speed Optimization fits situations like: someone reports search is slow; queries take too long; throughput too low; filtered search is slow.

How do I install Qdrant Search Speed Optimization in Claude Code?

Run `npx skills add qdrant/skills --skill qdrant-search-speed-optimization -a claude-code`. Or copy the skill folder (skills/qdrant-performance-optimization/search-speed-optimization in qdrant/skills) into .claude/skills/qdrant-search-speed-optimization in your project. Claude Code loads it when a task matches its description.

How do I install Qdrant Search Speed Optimization in Codex?

Run `npx skills add qdrant/skills --skill qdrant-search-speed-optimization -a codex`. Or copy the skill folder (skills/qdrant-performance-optimization/search-speed-optimization in qdrant/skills) into .agents/skills/qdrant-search-speed-optimization in your project. Codex loads it when a task matches its description.

Can I use Qdrant Search Speed Optimization 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-speed-optimization -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-speed-optimization, .gemini/skills/qdrant-search-speed-optimization, .github/skills/qdrant-search-speed-optimization and .opencode/skills/qdrant-search-speed-optimization in your project.

What does Qdrant Search Speed Optimization need to run?

SKILL.md names no scripts, command-line tools or credentials: Qdrant Search Speed Optimization is instructions for the agent only.

Does Qdrant Search Speed Optimization 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 Speed Optimization 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 Speed Optimization use?

Qdrant Search Speed Optimization 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 Speed Optimization use?

About 1.2k tokens (SKILL.md is roughly 4.9k 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 Speed Optimization?

Skills that share tags, products or a category with Qdrant Search Speed Optimization: Codebase Exploration (giancarloerra/SocratiCode, 3.3k stars), Qdrant Vector Search (Orchestra-Research/AI-Research-SKILLs, 13k stars), Using Vector Databases (ancoleman/ai-design-components, 526 stars) and Qdrant Search Strategies (github/awesome-copilot, 40k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Qdrant Search Speed Optimization?

qdrant (a GitHub organization, an official publisher) maintains it in qdrant/skills, which has 253 GitHub stars. The repository holds 33 skills in this directory. The repository was last updated on October 6, 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.