Official agent skill

Qdrant Tenant Scaling

by qdrant in qdrant/skills

Guides Qdrant multi-tenant scaling. An agent skill from qdrant/skills.

OfficialApache-2.0Auto-check passedBackend & APIs

Install Qdrant Tenant Scaling

skills CLI
$ npx skills add qdrant/skills --skill qdrant-tenant-scaling -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install qdrant/skills qdrant-tenant-scaling --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/qdrant/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/qdrant-scaling/scaling-data-volume/tenant-scaling .claude/skills/qdrant-tenant-scaling && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
qdrant-tenant-scaling
GitHub stars
253
Used in
2 other repos
Token cost
~916 tokens
SKILL.md length
414 words
Files
1
Skills in repo
33
Repo updated
First seen
Licence
Apache-2.0

At a glance

Guides Qdrant multi-tenant scaling. An agent skill from qdrant/skills.

  • Someone asks how to scale tenants
  • SKILL.md covers Number of Tenants is around 10k, Number of Tenants is around…, If tenants are unevenly sized and Need Per-Tenant Encryption or…, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • One collection per tenant?

What it does

Qdrant Tenant Scaling is an agent skill from qdrant/skills, published by the product's own GitHub organization. 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 shared infrastructure.

Its SKILL.md is about 920 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Backend & APIs, covering Vector databases and Multi-tenancy. It works with Qdrant. The repository describes itself as: Agent skills for Qdrant vector search: scaling, performance optimization, search quality, monitoring, deployment, model migration, version upgrades, and SDK usage across Python…. The licence is Apache-2.0.

When your agent uses it

  • Someone asks how to scale tenants
  • One collection per tenant?
  • Tenant isolation
  • Dedicated shards

Example prompts

  • “how to scale tenants”
  • “one collection per tenant?”
  • “tenant isolation”
  • “/qdrant-tenant-scaling”

What it can do on your machine

Read from SKILL.md and the folder at commit 476a18d. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • skills.qdrant.tech

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Qdrant Tenant Scaling loads about 916 tokens when it runs. Until then it costs about 70 tokens; SKILL.md has 414 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~70
When it runs · the whole SKILL.md, loaded when a task matches
~916

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from qdrant/skills at commit 476a18d, republished under its Apache-2.0 licence (© qdrant). 414 words, ~916 tokens.

Download SKILL.mdSave it as .claude/skills/qdrant-tenant-scaling/SKILL.md (or your agent's skills folder).
name
qdrant-tenant-scaling
description
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 shared infrastructure.

What to Do When Scaling Multi-Tenant Qdrant

Do not create one collection per tenant. Does not scale past a few hundred and wastes resources. One company hit the 1000 collection limit after a year of collection-per-repo and had to migrate to payload partitioning. Use a shared collection with a tenant key.

"Isolated" tenant queries — each tenant only ever sees its own data, with good performance — is the default outcome of payload filtering (is_tenant=true) in a single shared collection. It does not require separate collections. Separate collections only apply to the legal/compliance case, not as a way to get isolation.

Here is a short summary of the patterns:

Number of Tenants is around 10k

Use the default multitenancy strategy via payload filtering.

Read about Partition by payload and Calibrate performance for best practices on indexing and query performance.

Number of Tenants is around 100k and more

At this scale, the cluster may consist of several peers. To localize tenant data and improve performance, use custom sharding to assign tenants to specific shards based on tenant ID hash. This will localize tenant requests to specific nodes instead of broadcasting them to all nodes, improving performance and reducing load on each node.

If tenants are unevenly sized

If some tenants are much larger than others, use tiered multitenancy to promote large tenants to dedicated shards while keeping small tenants on shared shards. This optimizes resource allocation and performance for tenants of varying sizes.

Show full SKILL.md (170 more words)Show less

Use when: legal/compliance requirements demand per-tenant encryption keys or physical data separation — not merely "tenants shouldn't see each other's data," which payload filtering already guarantees on its own.

  • Multiple collections may be necessary for per-tenant encryption keys
  • Limit collection count and use payload filtering within each collection
  • This is the exception, not the default. Only use when compliance requires it.

What NOT to Do

  • Do not create one collection per tenant without compliance justification (does not scale past hundreds)
  • Do not treat "isolated" or "isolation" in a request as a reason to use separate collections — default query isolation comes from payload filtering (is_tenant=true) in a shared collection, not from separate collections
  • Do not skip is_tenant=true on the tenant index (kills sequential read performance)
  • Do not disable the global HNSW index (m: 0 with payload_m) by default: do it only when indexing speed is the bottleneck and cross-tenant search is rare, because global queries without a tenant filter get slower Multitenancy

© qdrant, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/qdrant-scaling/scaling-data-volume/tenant-scaling of qdrant/skills.

Open the folder on GitHubat commit 476a18d

Used in 2 other repositories

We found 2 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 2 other GitHub owners. This page covers the copy in qdrant/skills, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Qdrant Tenant Scaling next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Qdrant Tenant Scaling compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Qdrant Tenant Scaling this skillqdrant/skills2532 repos~916Automated safety check: PassApache-2.0
Agentsop Multi Tenant RAGagentsope/SkillAlchemy459—~9.8kAutomated safety check: PassMIT
Codebase Managementgiancarloerra/SocratiCode3.3k1 repos~1.8kAutomated safety check: PassAGPL-3.0
Codebase Explorationgiancarloerra/SocratiCode3.3k1 repos~1.5kAutomated safety check: PassAGPL-3.0
Cognee Community Packagestopoteretes/cognee32k—~1.2kAutomated safety check: PassApache-2.0
Pinecone Vector DatabaseOrchestra-Research/AI-Research-SKILLs13k6 repos~2kAutomated safety check: PassMIT

Similar skills

  • Agentsop Multi Tenant RAG

    agentsope/SkillAlchemy

    Security-first SOP for multi-tenant RAG systems. An agent skill from agentsope/SkillAlchemy.

    459 GitHub stars~9.8k tokensUpdated 1 mo ago
    AI & LLM EngineeringAuto-check passed
  • Codebase Management

    giancarloerra/SocratiCode

    Set up, index, and manage SocratiCode codebase indexing. An agent skill from giancarloerra/SocratiCode.

    3.3k GitHub starsUsed in 1 repo~1.8k tokens
    AI & LLM EngineeringAuto-check passed
  • Codebase Exploration

    giancarloerra/SocratiCode

    Explore and understand codebases using SocratiCode semantic search, dependency graphs, and context artifacts.

    3.3k GitHub starsUsed in 1 repo~1.5k tokens
    DatabasesAuto-check passed
  • Cognee Community Packages

    topoteretes/cognee

    Guide to using and contributing cognee community packages: database adapters, data-source connectors, custom tasks and retrievers, and Keywords AI observability.

    32k GitHub stars~1.2k tokensUpdated today
    DatabasesAuto-check passed
  • Pinecone Vector Database

    Orchestra-Research/AI-Research-SKILLs

    Shows how to use Pinecone, a managed vector database, for production RAG, semantic search and recommendations: indexes, upserts, queries, filters and namespaces.

    13k GitHub starsUsed in 6 repos~2k tokens
    DatabasesAuto-check passed
  • Qdrant Vector Search

    Orchestra-Research/AI-Research-SKILLs

    Explains how to run Qdrant, a Rust vector database, for RAG and semantic search, covering collections, points, distance metrics and filtered or batched queries.

    13k GitHub starsUsed in 5 repos~3.4k tokens
    DatabasesAuto-check passed

More from qdrant/skills

All 33 skills in this repo
  • Qdrant Clients SDK

    qdrant/skills

    Official

    Qdrant provides client SDKs for various programming languages, allowing easy integration with Qdrant deployments.

    253 GitHub starsUsed in 2 repos~752 tokens
    Auto-check: notes
  • Qdrant Advisor

    qdrant/skills

    Official

    Diagnose, troubleshoot, and advise on any Qdrant deployment by loading the latest official Qdrant skills live from skills.qdrant.tech.

    253 GitHub stars~1.7k tokensUpdated yesterday
    Auto-check passed
  • Official

    Guides Qdrant deployment selection. An agent skill from qdrant/skills.

    253 GitHub starsUsed in 2 repos~976 tokens
    Auto-check passed
  • Official

    Guides Qdrant search strategy selection. An agent skill from qdrant/skills.

    253 GitHub stars~1.3k tokensUpdated yesterday
    Auto-check passed
  • Official

    Diagnoses and guides Qdrant horizontal scaling decisions. An agent skill from qdrant/skills.

    253 GitHub starsUsed in 2 repos~833 tokens
    Auto-check passed

Works with

Questions about Qdrant Tenant Scaling

What does Qdrant Tenant Scaling do?

Guides Qdrant multi-tenant scaling. An agent skill from qdrant/skills. Qdrant Tenant Scaling is an agent skill from qdrant/skills, published by the product's own GitHub organization. Guides Qdrant multi-tenant scaling.

When should I use Qdrant Tenant Scaling?

Qdrant Tenant Scaling fits situations like: someone asks how to scale tenants; one collection per tenant?; tenant isolation; dedicated shards.

How do I install Qdrant Tenant Scaling in Claude Code?

Run `npx skills add qdrant/skills --skill qdrant-tenant-scaling -a claude-code`. Or copy the skill folder (skills/qdrant-scaling/scaling-data-volume/tenant-scaling in qdrant/skills) into .claude/skills/qdrant-tenant-scaling in your project. Claude Code loads it when a task matches its description.

How do I install Qdrant Tenant Scaling in Codex?

Run `npx skills add qdrant/skills --skill qdrant-tenant-scaling -a codex`. Or copy the skill folder (skills/qdrant-scaling/scaling-data-volume/tenant-scaling in qdrant/skills) into .agents/skills/qdrant-tenant-scaling in your project. Codex loads it when a task matches its description.

Can I use Qdrant Tenant Scaling in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add qdrant/skills --skill qdrant-tenant-scaling -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/qdrant-tenant-scaling, .gemini/skills/qdrant-tenant-scaling, .github/skills/qdrant-tenant-scaling and .opencode/skills/qdrant-tenant-scaling in your project.

What does Qdrant Tenant Scaling need to run?

SKILL.md names no scripts, command-line tools or credentials: Qdrant Tenant Scaling is instructions for the agent only.

Does Qdrant Tenant Scaling access the network?

SKILL.md names 1 domain. As links in the text: skills.qdrant.tech. This is read from the text; nothing was executed.

Is Qdrant Tenant Scaling safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Qdrant Tenant Scaling use?

Qdrant Tenant Scaling is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Qdrant Tenant Scaling use?

About 916 tokens (SKILL.md is roughly 3.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Qdrant Tenant Scaling?

Skills that share tags, products or a category with Qdrant Tenant Scaling: Agentsop Multi Tenant RAG (agentsope/SkillAlchemy, 459 stars), Codebase Management (giancarloerra/SocratiCode, 3.3k stars), Codebase Exploration (giancarloerra/SocratiCode, 3.3k stars) and Cognee Community Packages (topoteretes/cognee, 32k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Qdrant Tenant Scaling?

qdrant (a GitHub organization, an official publisher) maintains it in qdrant/skills, which has 253 GitHub stars. The repository holds 33 skills in this directory. The repository was last updated on October 7, 2026.

Source: qdrant/skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.