qdrant/skills

qdrant-scaling

Guides Qdrant scaling decisions. Use when someone asks 'how many nodes do I need', 'data doesn't fit on one node', 'need more throughput or QPS', 'CPU is pegged / can't keep up with the request rate', 'one query is slow / p99 or tail latency too high', 'cluster is slow', 'too many tenants', 'vertical or horizontal', 'how to shard', 'need to add capacity', 'large limit / pagination / scroll is slow', or 'only recent data matters / expiring old vectors / retention window'.

All-time #8070 Hot #4083 First seen Mar 31, 2026
8-week activity · all time api

Installation

$ npx skills add qdrant/skills --skill qdrant-scaling

Summary

  • Guides Qdrant scaling decisions.
  • Use when someone asks 'how many nodes do I need', 'data doesn't fit on one node', 'need more throughput or QPS', 'CPU is pegged / can't keep up with the request rate', 'one query is slow / p99 or tail latency too high', 'cluster is slow', 'too many tenants', 'vertical or horizontal', 'how to shard', 'need to add capacity', 'large limit / pagination / scroll is slow', or 'only recent data matters / expiring old vectors / retention window'.

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

Also in this package

Other skills from qdrant/skills · top by installs.

npx skills add qdrant/skills

Browse all from qdrant/skills

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Also listed on

Alternate registries and mirrors of this skill.

Repository health

Stars 230
License LICENSE
Default branch main
Open issues 5
Status Active

Skill metadata

Parsed from SKILL.md frontmatter.

Allowed toolsRead, Grep, Glob

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 2,404 B
  • docs SUMMARY.md 494 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 1,400 installs

SKILL.md

Qdrant Scaling

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
Data does not fit on a single node, running out of disk or memory as the dataset grows scaling-data-volume/SKILL.md
Need to shard the collection across more nodes, data outgrew one node scaling-data-volume/SKILL.md
Cannot handle enough parallel queries, need higher QPS or throughput scaling-qps/SKILL.md
Can't hold the request rate, CPU is pegged scaling-qps/SKILL.md
A single query is too slow, need to cut the tail latency of individual requests minimize-latency/SKILL.md
p99 or tail latency too high, but traffic/QPS is fine minimize-latency/SKILL.md
Queries return very large result sets and slow down scaling-query-volume/SKILL.md
Large limit, top-1000 queries, pagination, scroll across shards scaling-query-volume/SKILL.md
Many tenants or customers, one collection each, tenant isolation scaling-data-volume/tenant-scaling/SKILL.md
Only recent data matters, retention, expiring old vectors, time-based rotation scaling-data-volume/sliding-time-window/SKILL.md
Single node no longer fits the workload, before deciding to shard scaling-data-volume/vertical-scaling/SKILL.md
Already vertically maxed out, need more nodes, resharding scaling-data-volume/horizontal-scaling/SKILL.md

Latency and throughput pull opposite ways on segment count. For latency, increase segments toward the CPU core count (defaultsegmentnumber: 16). For throughput, use fewer and larger segments (defaultsegmentnumber: 2). Applying the wrong direction makes the reported problem worse.