A collection of structured agent skills that encode Qdrant vector search expertise for scaling, performance optimization, search quality, monitoring, and deployment decisions. Designed as problem-solving handbooks for coding agents across Python, TypeScript, Rust, Go, .NET, and Java SDKs, these skills can be used via URL or installed locally for offline access.
Agent skills for Qdrant vector search: scaling, performance optimization, search quality, monitoring, deployment, model migration, version upgrades, and SDK usage across Python, TypeScript, Rust, Go, .NET, Java
230Stars
26Forks
16Open issues
2Watching
Python Apache-2.0 v0.1.0 Updated 4 weeks ago
At a glance
Python Actively maintained Commercial OK
README
Qdrant Skills - Agent Skills for Qdrant Vector Search
Skills encode deep Qdrant knowledge so coding agents can make the engineering decisions that determine whether vector search works well: quantization, sharding, tenant isolation, hybrid search, model migration, and more.
Philosophy
Skills are not documentation. Qdrant already has docs in markdown. Skills answer "when?" and "why?", not "how?"
They are structured as the handbook of a Solutions Architect working on Qdrant: given a problem, navigate to the exact place in the documentation where the answer lives. No tutorials, no concept explanations. Only references and minimal snippets where absolutely necessary.
Disclaimer
These skills are under active development. Skill content and structure may change between versions as Qdrant evolves.
Usage
Qdrant maintains a growing set of skills, and their content changes as Qdrant evolves. There are a few ways to give your agent access to them.
Recommended: install the Qdrant Advisor
Install one skill — the Qdrant Advisor — and your agent always has the freshest, most relevant Qdrant guidance, with nothing to manage as the skills change:
npx skills add qdrant/skills/meta/qdrant-advisor
The Advisor ships no static content of its own. When you raise a Qdrant problem, it searches skills.qdrant.tech live, traverses the skill hierarchy along the branch that matches your symptom, and grounds its diagnosis in the current, authoritative guidance, loading only the relevant context. Because it fetches fresh every session, you don't need to reinstall to stay current, and you don't have to remember a URL or hope the site is in the model's training data.
Using the claude.ai web app? The Advisor can't fetch
skills.qdrant.techon its own when you are using the web app. You need to addUse skills.qdrant.techto your prompt (refer to Pass the URL directly).
Alternative: pass the URL directly
If you'd rather not install anything, pass the URL of the skills site in your prompt. The agent fetches the skill relevant to your current problem:
Use skills.qdrant.tech
This keeps context focused, but you have to include the URL in every prompt.
Offline: install the full skill set
If you want the skills available offline, or triggered automatically without the Advisor, install the complete set locally. See the Installation section.
Quick Start
With the Qdrant Advisor installed, just ask your agent about Qdrant. The Advisor triggers automatically and loads the matching guidance live:
"I have 50M vectors on a single node and search is slow, should I add more nodes?"
→ Advisor loads the scaling guidance, recommends quantization and vertical scaling before adding nodes
"My search results are returning irrelevant matches"
→ Advisor loads the search-quality guidance, walks through diagnosis and search strategy options
"How do I switch from OpenAI embeddings to Cohere without downtime?"
→ Advisor loads the model-migration guidance for a zero-downtime switch with dual vectors
Prefer the URL method? Add Use skills.qdrant.tech to the same prompts:
"I have 50M vectors on a single node and search is slow, should I add more nodes? Use skills.qdrant.tech"
"My search results are returning irrelevant matches. Use skills.qdrant.tech"
Skills
| Skill | Useful for |
|---|---|
| qdrant-clients-sdk | SDK setup, code examples, snippet search across Python, TypeScript, Rust, Go, .NET, Java |
| qdrant-scaling | Scaling decisions: data volume, QPS, latency, query volume, horizontal vs vertical |
| qdrant-sizing | Sizing RAM, disk, CPU, and node count before a deployment is provisioned. |
| qdrant-performance-optimization | Search speed, memory usage, indexing performance |
| qdrant-search-quality | Diagnosing bad results, search strategies, hybrid search |
| qdrant-monitoring | Metrics, health checks, debugging optimizer and cluster issues |
| qdrant-multitenancy | Isolating multiple tenants within a Qdrant deployment: payload partitioning, tiered multitenancy, and region-based data isolation |
| qdrant-deployment-options | Choosing between local, self-hosted, cloud, and hybrid |
| qdrant-edge | Building on the embedded shard: server sync, on-device BM25, snapshots, reuse vs reimplement |
| qdrant-model-migration | Switching embedding models without downtime |
| qdrant-version-upgrade | Safe upgrade paths, compatibility guarantees, rolling upgrades |
Installation
Qdrant Advisor (recommended)
If you want a single, always-current skill instead of the full set, install only the Qdrant Advisor:
npx skills add qdrant/skills/meta/qdrant-advisor
This installs just the qdrant-advisor meta-skill. It ships no static content of its own, it loads the relevant Qdrant skills live from skills.qdrant.tech on demand, so you always get the latest guidance without reinstalling. It is not part of the npx skills add qdrant/skills bundle.
npx skills
Install using the npx skills CLI:
npx skills add qdrant/skills
Claude Code
Add the marketplace, then install all Qdrant skills:
/plugin marketplace add qdrant/skills
/plugin install qdrant@qdrant
Cursor
Install from the Cursor Marketplace or add manually via Settings > Rules > Add Rule > Remote Rule (GitHub) with qdrant/skills.
Clone / Copy
Clone this repo and copy the skill folders into the appropriate directory for your agent:
| Agent | Skill Directory | Docs |
|---|---|---|
| Claude Code | ~/.claude/skills/ |
docs |
| Cursor | .cursor/skills/ |
docs |
| OpenCode | ~/.config/opencode/skill/ |
docs |
| OpenAI Codex | ~/.codex/skills/ |
docs |
| Pi | ~/.pi/agent/skills/ |
docs |
MCP Servers
For additional Qdrant context, pair skills with these MCP servers:
| Server | Purpose |
|---|---|
| mcp-code-snippets | Search Qdrant docs and code examples across all SDKs |
| mcp-server-qdrant | Store and retrieve memories, manage collections directly |
Getting Help
Found a bug or wrong advice in a skill? Open an issue on GitHub and include:
- The skill name
- The prompt you gave your agent
- What the agent said vs what it should have said
Contributing
If you are interested in contributing, follow the instructions in CONTRIBUTING.md.
30 skills in this repo
Plugin marketplace
Qdrant Advisor
DevOps & Infrastructure
Diagnose, troubleshoot, and advise on any Qdrant deployment by loading the latest official Qdrant skills live from skills.qdrant.tech. Use this whenever someone raises a Qdrant problem or question — slow or degraded search, high or growing...
Install
/plugin marketplace add qdrant/skills
/plugin install qdrant-advisor
Qdrant Clients SDK
DevOps & Infrastructure
Qdrant provides client SDKs for various programming languages, allowing easy integration with Qdrant deployments.
Install
/plugin marketplace add qdrant/skills
/plugin install qdrant-clients-sdk
Qdrant Deployment Options
DevOps & Infrastructure
Guides Qdrant deployment selection. Use when someone asks 'how to deploy Qdrant', 'Docker vs Cloud', 'local mode', 'embedded Qdrant', 'Qdrant EDGE', 'which deployment option', 'self-hosted vs cloud', or 'need lowest latency deployment'. Als...
Install
/plugin marketplace add qdrant/skills
/plugin install qdrant-deployment-options
Qdrant Edge
Coding
Guides building on Qdrant Edge, the embedded in-process shard. Use when someone asks 'how to sync Edge with the server', 'keep a local shard in sync with Qdrant Cloud', 'BM25 or keyword search on Edge', 'hybrid search on Edge', 'embeddings...
Install
/plugin marketplace add qdrant/skills
/plugin install qdrant-edge
Qdrant Horizontal Scaling
DevOps & Infrastructure
Diagnoses and guides Qdrant horizontal scaling decisions. Use when someone asks 'vertical or horizontal?', 'how many nodes?', 'how many shards?', 'how to add nodes', 'resharding', 'data doesn't fit', or 'need more capacity'. Also use when d...
Install
/plugin marketplace add qdrant/skills
/plugin install qdrant-horizontal-scaling
Qdrant Hybrid Search
Presentations
Explains hybrid search in Qdrant. Use when someone asks 'how do I setup hybrid search?', 'how to combine keyword and semantic search?', 'sparse plus dense vectors?', 'missing keyword matches', 'how to combine results from multiple searches?...
Install
/plugin marketplace add qdrant/skills
/plugin install qdrant-hybrid-searchFusing scores from multiple searches into a single ranked result (RRF, DBSF, custom fusion). Use when someone asks 'RRF or DBSF?', 'how to combine sparse and dense', 'how to combine scores from multiple searches?', 'custom fusion', or 'fusi...
Install
/plugin marketplace add qdrant/skills
/plugin install qdrant-hybrid-search-combiningConstructing prefetch queries for hybrid retrieval, including sparse/dense and multi-field setups, and choosing a sparse embedding model. Use when someone asks 'dense and sparse in one search?', 'how to combine multiple fields for retrieval...
Install
/plugin marketplace add qdrant/skills
/plugin install qdrant-hybrid-search-prefetches
Qdrant Indexing Performance Optimization
DevOps & Infrastructure
Diagnoses and fixes slow Qdrant indexing and data ingestion. Use when someone reports 'uploads are slow', 'indexing takes forever', 'optimizer is stuck', 'HNSW build time too long', or 'data uploaded but search is bad'. Also use when optimi...
Install
/plugin marketplace add qdrant/skills
/plugin install qdrant-indexing-performance-optimization
Qdrant Memory Usage Optimization
DevOps & Infrastructure
Diagnoses and reduces Qdrant memory usage. Use when someone reports 'memory too high', 'RAM keeps growing', 'node crashed', 'out of memory', 'memory leak', or asks 'why is memory usage so high?', 'how to reduce RAM?'. Also use when memory d...
Install
/plugin marketplace add qdrant/skills
/plugin install qdrant-memory-usage-optimization
Qdrant Minimize Latency
DevOps & Infrastructure
Guides Qdrant query latency optimization. Use when someone asks 'search is slow', 'how to reduce latency', 'p99 is too high', 'tail latency', 'single query too slow', 'how to make search faster', or 'latency spikes'.
Install
/plugin marketplace add qdrant/skills
/plugin install qdrant-minimize-latency
Qdrant Model Migration
DevOps & Infrastructure
Guides embedding model migration in Qdrant without downtime. Use when someone asks 'how to switch embedding models', 'how to migrate vectors', 'how to update to a new model', 'zero-downtime model change', 'how to re-embed my data', or 'can...
Install
/plugin marketplace add qdrant/skills
/plugin install qdrant-model-migration
Qdrant Monitoring
Coding
Guides Qdrant monitoring and observability setup. Use when someone asks 'how to monitor Qdrant', 'what metrics to track', 'is Qdrant healthy', 'optimizer stuck', 'why is memory growing', 'requests are slow', or needs to set up Prometheus, G...
Install
/plugin marketplace add qdrant/skills
/plugin install qdrant-monitoring
Qdrant Monitoring Debugging
Coding
Diagnoses Qdrant production issues using metrics and observability tools. Use when someone reports 'optimizer stuck', 'indexing too slow', 'memory too high', 'OOM crash', 'queries are slow', 'latency spike', or 'search was fast now it's slo...
Install
/plugin marketplace add qdrant/skills
/plugin install qdrant-monitoring-debugging
Qdrant Monitoring Setup
Data & Analytics
Guides Qdrant monitoring setup including Prometheus scraping, health probes, Hybrid Cloud metrics, alerting, and log centralization. Use when someone asks 'how to set up monitoring', 'Prometheus config', 'Grafana dashboard', 'health check e...
Install
/plugin marketplace add qdrant/skills
/plugin install qdrant-monitoring-setup
Qdrant Multitenancy
Coding
Guides tenant isolation architecture in Qdrant for multi-tenant or multi-user applications. Use when someone asks 'how to isolate customer data', 'how to build multi-tenant search/RAG', 'how many collections should I create', 'how to partit...
Install
/plugin marketplace add qdrant/skills
/plugin install qdrant-multitenancy
Qdrant Performance Optimization
DevOps & Infrastructure
Navigation hub linking sub-skills for proactive Qdrant tuning: search speed, indexing performance, and memory usage optimization. Use when planning configuration or capacity changes to improve speed and efficiency. For diagnosing an active...
Install
/plugin marketplace add qdrant/skills
/plugin install qdrant-performance-optimization
Qdrant Relevance Feedback
Data & Analytics
Expanding the candidate pool via relevance feedback, as an alternative to reranking when a dense retriever is too weak. Use when someone asks about 'Qdrant's Relevance Feedback API', 'improving dense search relevance/recall', 'how to discov...
Install
/plugin marketplace add qdrant/skills
/plugin install qdrant-relevance-feedback
Qdrant Scaling
DevOps & Infrastructure
Guides Qdrant scaling decisions. Use when someone asks 'how many nodes do I need', 'data doesn't fit on one node', 'need more throughput', 'cluster is slow', 'too many tenants', 'vertical or horizontal', 'how to shard', or 'need to add capa...
Install
/plugin marketplace add qdrant/skills
/plugin install qdrant-scaling
Qdrant Scaling Data Volume
DevOps & Infrastructure
Guides Qdrant data volume scaling decisions. Use when someone asks 'data doesn't fit on one node', 'too much data', 'need more storage', 'vertical or horizontal scaling', 'tenant scaling', 'time window rotation', or 'data growth exceeds cap...
Install
/plugin marketplace add qdrant/skills
/plugin install qdrant-scaling-data-volume
Qdrant Scaling Qps
DevOps & Infrastructure
Guides Qdrant query throughput (QPS) scaling. Use when someone asks 'how to increase QPS', 'need more throughput', 'queries per second too low', 'batch search', 'read replicas', or 'how to handle more concurrent queries'.
Install
/plugin marketplace add qdrant/skills
/plugin install qdrant-scaling-qps
Qdrant Scaling Query Volume
DevOps & Infrastructure
Guides Qdrant query volume scaling. Use when someone asks 'query returns too many results', 'scroll performance', 'large limit values', 'paginating search results', 'fetching many vectors', or 'high cardinality results'.
Install
/plugin marketplace add qdrant/skills
/plugin install qdrant-scaling-query-volume
Qdrant Search Quality
Code Review & Testing
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?', '...
Install
/plugin marketplace add qdrant/skills
/plugin install qdrant-search-quality
Qdrant Search Quality Diagnosis
Code Review & Testing
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', 'quality droppe...
Install
/plugin marketplace add qdrant/skills
/plugin install qdrant-search-quality-diagnosis
Qdrant Search Speed Optimization
DevOps & Infrastructure
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 se...
Install
/plugin marketplace add qdrant/skills
/plugin install qdrant-search-speed-optimization
Qdrant Search Strategies
Legal
Guides Qdrant search strategy selection. Use when someone asks 'should I use hybrid search?', 'how to rerank?', 'results are not relevant', 'I don't get needed results from my dataset but they're there', 'retrieval quality is not good enoug...
Install
/plugin marketplace add qdrant/skills
/plugin install qdrant-search-strategies
Qdrant Sliding Time Window
DevOps & Infrastructure
Guides sliding time window scaling in Qdrant. Use when someone asks 'only recent data matters', 'how to expire old vectors', 'time-based data rotation', 'delete old data efficiently', 'social media feed search', 'news search', 'log search w...
Install
/plugin marketplace add qdrant/skills
/plugin install qdrant-sliding-time-window
Qdrant Tenant Scaling
DevOps & Infrastructure
Guides Qdrant multi-tenant scaling. Use when someone asks 'how to scale tenants', 'one collection per tenant?', 'tenant isolation', 'dedicated shards', or reports tenant performance issues. Also use when multi-tenant workloads outgrow share...
Install
/plugin marketplace add qdrant/skills
/plugin install qdrant-tenant-scaling
Qdrant Version Upgrade
DevOps & Infrastructure
Covers upgrading Qdrant server and SDKs without interrupting availability or losing data integrity. Use when someone asks 'how do I upgrade Qdrant', 'can I jump from 1.15 to 1.18', 'rolling upgrade without downtime', 'do I upgrade the clien...
Install
/plugin marketplace add qdrant/skills
/plugin install qdrant-version-upgrade
Qdrant Vertical Scaling
DevOps & Infrastructure
Guides Qdrant vertical scaling decisions. Use when someone asks 'how to scale up a node', 'need more RAM', 'upgrade node size', 'vertical scaling', 'resize cluster', 'scale up vs scale out', or when memory/CPU is insufficient on current nod...
Install
/plugin marketplace add qdrant/skills
/plugin install qdrant-vertical-scalingComments (0)
Sign in to join the discussion.
No comments yet
Be the first to share your take.