qdrant
Agent skills for Qdrant vector search: scaling, performance optimization, search quality, monitoring, deployment, edge, model migration, version upgrades, and SDK usage
pinned to #8ba95bcupdated 2 weeks ago
Ask your AI client: “install plugins/qdrant”.
Requires the metahub MCP server installed in your client. Set up MCP.
mh install plugins/qdrantmetahub onboarded this repo on the author's behalf.
If you own github.com/qdrant/skills on GitHub, claim the listing to take over publishing. Your claim preserves the existing eval history and badges; only the curator label is replaced with verified-publisher on your next publish.
Stars
196
Last commit
2 weeks ago
Latest release
published
- #agent-skills
- #ai-agents
- #claude-code
- #codex
- #cursor
- #embeddings
- #hybrid-search
- #monitoring
- #multitenancy
- #performance
- #qdrant
- #quantization
- #scaling
- #search-quality
- #vector-database
- #vector-search
What's bundled
Items extracted from this plugin's manifest + directory tree.
Skills (9)
skills/qdrant-clients-sdkQdrant provides client SDKs for various programming languages, allowing easy integration with Qdrant deployments.skills/qdrant-deployment-optionsGuides 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…skills/qdrant-edgeGuides 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 E…skills/qdrant-model-migrationGuides 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 c…skills/qdrant-monitoringGuides 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 …skills/qdrant-performance-optimizationNavigation 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 spee…skills/qdrant-scalingGuides 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 horizo…skills/qdrant-search-qualityDiagnoses and improves Qdrant search relevance. Use when someone reports 'search results are bad', 'wrong results', 'low precision', 'low recall', 'irrelevant matches', 'missing expected results', …
Evaluation report
PassingAutomated checks the publisher passed at publish time — structure, docs, safety, and whether the artifact behaves as claimed.8ba95bc· 2 weeks ago
Select a category above to see its individual checks.
Release history
1- releasecurrent8ba95bcpass2 weeks ago
Contents
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
Skills are hosted at skills.qdrant.tech. Pass the URL of a skill directly to your agent — no installation required:
Use skills.qdrant.tech
This keeps your agent's context focused: it fetches only the skill relevant to your current problem rather than loading everything upfront.
If you prefer skills to be available offline or without passing URLs manually, you can install them locally. Refer to the Installation section.
Quick Start
The recommended way is the URL method: ask your agent about Qdrant and pass skills.qdrant.tech in your prompt.
"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"
If you use the installation method, just ask your agent about Qdrant. Skills are triggered automatically when your question matches their description.
"I have 50M vectors on a single node and search is slow, should I add more nodes?"
→ qdrant-scaling skill activates, recommends quantization and vertical scaling before adding nodes
"My search results are returning irrelevant matches"
→ qdrant-search-quality skill activates, walks through diagnosis and search strategy options
"How do I switch from OpenAI embeddings to Cohere without downtime?"
→ qdrant-model-migration skill activates, guides zero-downtime migration with dual vectors
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-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-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
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.
Reviews
No reviews yet. Be the first.
Related
manifest-dev-tools
Tools for working with prompts and PRs alongside the manifest workflow. Collaborative PR walkthroughs, autonomous PR review with per-comment verification, author-side PR babysitting via manifest-dev, gap-calibrated prompt engineering, cross-boundary context handoff, and incremental teaching for session work.
plugin-template
A template for creating new Claude Code plugins
ru-text
Russian text quality plugin — typography, information style, editorial standards, UX writing, business correspondence, and AI-text cleanup
mh install plugins/qdrant