Qdrant Skills
Decision-focused Qdrant guidance for coding agents working on search quality, scaling, migration, deployment, and operations.
Per-dimension scores and reasoning
The workflows grant only contents: read, and third-party GitHub Actions are pinned to commit hashes, demonstrating strong least-privilege practice. The README discloses that the Advisor fetches skills.qdrant.tech live and identifies installation, network retrieval, and optional MCP effects. It does not explain query contents, logging, or retention, however, and it does not require confirmation before consequential upgrade, migration, or collection-management actions. The API key is injected through a workflow secret rather than embedded in source, but broader sensitive-data guidance is absent. Global npm and npx installation targets are not version-pinned, leaving supply-chain controls incomplete. No rollback, uninstall, or recovery procedure is supplied. Repository ownership cues, issue routing, licensing, and the copyright holder support attribution, but the claim that live guidance is current and authoritative is not further substantiated by the supplied files.
The README is internally coherent across its stated purpose, skill catalog, installation modes, and examples. Live Advisor, direct-URL, and offline options provide some resilience against a single unavailable delivery path. Link-checking and evaluation workflows show an intent to perform continuous checks, but the evaluation script, test definitions, results, and passing status are absent, so actual reliability cannot be inferred. One claude.ai fetching limitation is clearly documented, while systematic runtime failure messages and handling for timeouts, network outages, or failed dependency installation are not shown.
The source clearly addresses scaling, performance, search quality, monitoring, deployment, migration, upgrades, and six SDK ecosystems, with symptom-based examples that distinguish user scenarios. It bounds the skills toward “when” and “why,” describes hierarchical documentation navigation, states that the Advisor contains no static content, and identifies a claude.ai fetching constraint. Boundaries around prohibited actions or mandatory human escalation remain incomplete. The skill table and examples support routing, but exact automatic-trigger matching, ambiguity resolution, and precedence rules are not shown. Multiple agent-specific installation paths plus live, URL, and offline modes provide strong environment fit.
The README has clear sections for philosophy, usage, skills, installation, MCP servers, help, and contribution. Commands and agent-specific directories are concrete, and skill names are used consistently. Examples cover major scenarios, but there is no substantive FAQ, troubleshooting set, or complete expected-output example. Active development, possible structural change, and a claude.ai limitation are disclosed, although compatibility, operational, and safety limitations are not systematically catalogued. The complete Apache-2.0 license and copyright notice justify full license credit. No release version scheme, changelog, or compatibility history is supplied beyond a general change disclaimer. Qdrant naming, the copyright holder, issue route, and contribution route establish a maintenance path, but named maintainers, service expectations, and governance details are absent; publisher identity remains unverified as stipulated.
Symptom-oriented skill separation, minimal snippets, and selective loading plausibly yield actionable engineering guidance and add value beyond undirected documentation search. The README provides illustrative recommendations and explains focused-context and freshness benefits, but the supplied evidence omits the actual skill bodies, complete outputs, and evaluation results, limiting output-usability and marginal-value scores. Live, direct-URL, and offline choices create a reasonable tradeoff, while latency, token use, installation burden, privacy costs, and ongoing maintenance costs are not quantified.
Core claims are traceable to named skills, scenario tables, installation commands, the identified skills site, licensing, and two CI workflows. Dependency behavior is also visible through pinned Actions, npm installation, and secret injection. The evidence lacks skill contents, the evaluation script, evaluation artifacts, commit history, and referenced documentation, preventing cross-checking of claims such as “most relevant,” “authoritative,” “always current,” or the quality of example recommendations. Design philosophy, instructions, and examples are generally distinguishable, but several effectiveness claims are stated as facts without measurements or an explicit indication that they are unverified expectations.
- The Advisor sends or requests problem-related context from skills.qdrant.tech live. Before using private architecture, customer data, or internal incident details, verify that site's data-processing and logging policies.
- Scaling, model migration, version upgrades, and collection management can cause downtime, data loss, or cost changes. The supplied material does not require pre-action confirmation, backup, dry-run, or rollback steps.
- The npx and global npm installations do not pin package versions. Resolve and verify versions, provenance, integrity, and transitive dependencies in a controlled environment.
- Do not treat the presence of a CI workflow as evidence that evaluations pass; the supplied files contain no evaluation script, results, or independently cross-checkable quality evidence.
- Live content can change independently of the reviewed revision. For auditable or repeatable advice, use a pinned offline skill version and retain the referenced guidance.
What does this agent do, and when should you use it?
Qdrant Skills is a collection of specialist skills for coding agents working with Qdrant, spanning scaling, sizing, performance, search quality, monitoring, multitenancy, deployment, edge use, migration, upgrades, and SDK usage. Its recommended entry point, `qdrant-advisor`, contains no static guidance; during each session it searches `skills.qdrant.tech` and loads the branch relevant to the reported symptom. An alternative offline installation places the complete skill set in the local skill directory of Claude Code, Cursor, OpenCode, OpenAI Codex, or Pi. The skills produce engineering recommendations, links to authoritative guidance, and minimal snippets where necessary rather than operating a database or teaching Qdrant through tutorials. It is a good fit for teams adopting or running Qdrant that want an agent to assist with architecture and diagnosis, with the caveat that the project is under active development and its content and structure may change.
After a user describes a Qdrant problem, qdrant-advisor searches skills.qdrant.tech, follows the skill hierarchy that matches the symptom, and loads only the relevant guidance for the agent's diagnosis. Available modules include qdrant-scaling, qdrant-sizing, qdrant-performance-optimization, qdrant-search-quality, qdrant-monitoring, qdrant-multitenancy, qdrant-deployment-options, qdrant-edge, qdrant-migration-tool, qdrant-model-migration, qdrant-version-upgrade, and qdrant-clients-sdk. They guide decisions about scaling, hardware capacity, performance and relevance problems, tenant isolation, deployment models, zero-downtime embedding migration, safe upgrades, and SDK work in Python, TypeScript, Rust, Go, .NET, and Java. With the full local bundle, an agent can trigger the applicable skill without consulting the Advisor. Optional mcp-code-snippets and mcp-server-qdrant servers add snippet search or direct collection and memory operations; those capabilities are not implemented by this repository itself.
- An engineer running tens of millions of vectors on one node can assess whether quantization and vertical scaling should precede adding nodes.
- A search team seeing irrelevant matches can use
qdrant-search-qualityto diagnose the issue and evaluate strategies such as hybrid search. - A platform team planning a new deployment can use
qdrant-sizingto estimate RAM, disk, CPU, and node count before provisioning. - A SaaS team hosting multiple customers can evaluate payload partitioning, tiered multitenancy, and region-based isolation with
qdrant-multitenancy. - An application team changing embedding providers can use
qdrant-model-migrationto plan a zero-downtime transition with dual vectors. - Developers using Python, TypeScript, Rust, Go, .NET, or Java can consult
qdrant-clients-sdkfor setup and code examples.
What are this agent's strengths and limitations?
- The Advisor fetches relevant material from
skills.qdrant.techeach session, avoiding repeated reinstalls when guidance changes. - Symptom-based traversal loads only the portion of the skill hierarchy needed for the current problem.
- Coverage extends across Qdrant capacity planning, performance, relevance, multitenancy, deployment, migration, monitoring, and upgrades.
- Users can choose between a compact live Advisor and a complete offline skill bundle.
- The SDK skill explicitly covers Python, TypeScript, Rust, Go, .NET, and Java.
- The repository is under active development, so skill content and structure may change between versions.
- The live Advisor depends on access to
skills.qdrant.tech; offline users must install the complete bundle. - In the claude.ai web app, the Advisor cannot fetch the site autonomously, so the URL must be included in each prompt.
- The material is intentionally not tutorial or concept documentation, which may leave first-time Qdrant users needing separate learning resources.
- Direct collection management and cross-SDK snippet search require optional MCP servers and are not claimed as native repository functions.
How do you install or deploy this agent?
For the recommended live Advisor installation, run:
npx skills add qdrant/skills/meta/qdrant-advisorFor the complete offline or automatically triggered skill set, run:
npx skills add qdrant/skillsClaude Code also supports this documented sequence:
/plugin marketplace add qdrant/skills
/plugin install qdrant@qdrantA manual option is to clone the repository and copy skill folders into ~/.claude/skills/ for Claude Code, .cursor/skills/ for Cursor, ~/.config/opencode/skill/ for OpenCode, ~/.codex/skills/ for OpenAI Codex, or ~/.pi/agent/skills/ for Pi. The recommended path requires an environment capable of running the documented npx command. No Node.js version, credentials, or authentication setup is specified. The Advisor also requires network access to skills.qdrant.tech while in use.
How do you use this agent?
Once the Advisor is installed, ask the agent a concrete Qdrant question, such as: I have 50M vectors on a single node and search is slow, should I add more nodes? The Advisor automatically loads the matching scaling guidance. Without installing anything, append Use skills.qdrant.tech to each request, for example: My search results are returning irrelevant matches. Use skills.qdrant.tech. The URL must be supplied explicitly when using the claude.ai web app because the Advisor cannot fetch the site there on its own. With the complete local bundle installed, the relevant local skill can trigger directly without the Advisor.
How does this agent compare with similar options?
Compared with installing the full bundle, Qdrant Advisor installs one meta-skill with no static content and retrieves focused guidance during each session, improving freshness and reducing loaded context. The full bundle is better suited to offline use or automatic triggering without the Advisor. A third option requires no installation: include Use skills.qdrant.tech in every prompt, at the cost of repeating the URL each time.
FAQ
Does Qdrant Advisor require credentials?
skills.qdrant.tech.Can it directly manage Qdrant collections?
mcp-server-qdrant is suggested when direct collection and memory operations are needed.Can it work without internet access?
Does it support OpenAI Codex and Claude Code?
skills.qdrant.tech in the prompt.Is an MCP server required?
mcp-code-snippets and mcp-server-qdrant are optional additions for documentation and SDK snippet search or direct collection and memory operations.