SKILL·268382

qdrant-scaling-query-volume

qdrant
Updated 1 month ago
188
21
188
View on GitHub
Designdesign

About

This Claude skill provides Qdrant optimization strategies for handling large query volumes and pagination. It specifically addresses performance issues with high-limit queries across multiple shards by implementing Poisson distribution-based subsampling. Use this skill when dealing with scroll performance, large result sets, or high-cardinality queries in sharded Qdrant deployments.

Quick Install

Claude Code

Recommended
Primary
npx skills add qdrant/skills -a claude-code
Plugin CommandAlternative
/plugin add https://github.com/qdrant/skills
Git CloneAlternative
git clone https://github.com/qdrant/skills.git ~/.claude/skills/qdrant-scaling-query-volume

Copy and paste this command in Claude Code to install this skill

Documentation

Scaling for Query Volume

Problem: When a query has a large limit (e.g. 1000) and there are multiple shards (e.g. 10), naively each shard must return the full 1000 results — totaling 10,000 scored points transferred and merged. This is wasteful since data is randomly distributed across auto-shards.

Core idea

Instead of asking every shard for the full limit, ask each shard for a smaller limit computed via Poisson distribution statistics, then merge. This is safe because auto-sharding guarantees random, independent data distribution.

When it activates

  • More than 1 shard
  • Auto-sharding is in use (all queried shards share the same shard key)
  • The request's limit + offset >= SHARD_QUERY_SUBSAMPLING_LIMIT (128)
  • The query is not exact

Key tradeoff

The strategy trades a small probability of slightly incomplete results for a large reduction in inter-shard data transfer, especially for high-limit queries across many shards. The 1.2x safety factor and the 99.9% Poisson threshold keep the error rate very low — comparable to inaccuracies already introduced by approximate vector indices like HNSW.

GitHub Repository

qdrant/skills
Path: skills/qdrant-scaling/scaling-query-volume
0
agent-skillsai-agentsclaude-codecodexcursorembeddings
FAQ

Frequently asked questions

What is the qdrant-scaling-query-volume skill?

qdrant-scaling-query-volume is a Claude Skill by qdrant. Skills package instructions and resources that Claude loads on demand, so Claude can perform qdrant-scaling-query-volume-related tasks without extra prompting.

How do I install qdrant-scaling-query-volume?

Use the install commands on this page: add qdrant-scaling-query-volume to Claude Code as a plugin, or clone its repository into your skills directory, then restart Claude so it picks up the skill.

What category does qdrant-scaling-query-volume belong to?

qdrant-scaling-query-volume is in the Design category, tagged design.

Is qdrant-scaling-query-volume free to use?

Yes. qdrant-scaling-query-volume is listed on AIMCP and free to install. It runs inside Claude, so no separate service account is required to use the skill itself.

Related Skills

executing-plans
Design

Use the executing-plans skill when you have a complete implementation plan to execute in controlled batches with review checkpoints. It loads and critically reviews the plan, then executes tasks in small batches (default 3 tasks) while reporting progress between each batch for architect review. This ensures systematic implementation with built-in quality control checkpoints.

View skill
requesting-code-review
Design

This skill dispatches a code-reviewer subagent to analyze code changes against requirements before proceeding. It should be used after completing tasks, implementing major features, or before merging to main. The review helps catch issues early by comparing the current implementation with the original plan.

View skill
connect-mcp-server
Design

This skill provides a comprehensive guide for developers to connect MCP servers to Claude Code using HTTP, stdio, or SSE transports. It covers installation, configuration, authentication, and security for integrating external services like GitHub, Notion, and custom APIs. Use it when setting up MCP integrations, configuring external tools, or working with Claude's Model Context Protocol.

View skill
web-cli-teleport
Design

This skill helps developers choose between Claude Code Web and CLI interfaces based on task analysis, then enables seamless session teleportation between these environments. It optimizes workflow by managing session state and context when switching between web, CLI, or mobile. Use it for complex projects requiring different tools at various stages.

View skill