Skip to main content
skill GitHub Copilot official · GitHub

qdrant-version-upgrade — GitHub Copilot skill: what it does

Provides rules for upgrading Qdrant and its SDK without downtime or data corruption. Helps plan rolling cluster upgrades and multi-version storage migrations.

Install into GitHub Copilot · Skills CLI (Vercel) All methods and platforms ↓
npx skills add github/awesome-copilot --skill qdrant-version-upgrade
Open on GitHub

What qdrant-version-upgrade does

The skill outlines compatibility rules between Qdrant server and its client libraries. Order matters here. You first upgrade the SDK to the next minor version, and only then update the database server. Disk storage guarantees backward compatibility for only one minor version. Because of this, moving from 1.15.x to 1.17.x requires an intermediate step on 1.16.x.

Zero-downtime rolling upgrades require a replication factor of 2 or higher. Nodes are updated one by one while the remaining instances handle incoming traffic. In Qdrant Cloud, intermediate storage migrations run automatically, and environments can be managed through the qcloud CLI.

Install this skill if you operate self-hosted Qdrant nodes and need to safeguard your index data during upgrades. If you fully rely on Qdrant Cloud, you can safely skip these manual maintenance rules.

What it helps with

  • order SDK and server updates correctly
  • run zero-downtime rolling upgrades on clustered nodes
  • migrate storage files safely across minor releases
  • manage cluster updates using the qcloud CLI tool

Example prompts for the agent

  • How do I upgrade Qdrant from 1.15.x to 1.17.x without data loss?
  • Show me how to run a rolling upgrade on a Qdrant cluster with replication factor 2
  • Should I upgrade the Qdrant SDK or the server first?

How to install qdrant-version-upgrade

1Skills CLI (Vercel)

npx skills add github/awesome-copilot --skill qdrant-version-upgrade

2GitHub CLI

gh skill install github/awesome-copilot qdrant-version-upgrade

3Manually: put the files in place

.github/skills/qdrant-version-upgrade/SKILL.md

From the same set554

The whole set →
git-commit official github This skill reviews Git changes, stages related files, and creates Conventional Commits. Use it when you want an agent to make one commit or split work into separate commits. GitHub Copilot 47,165installs excalidraw-diagram-generator official github Turn a plain-language description into an Excalidraw diagram. Useful for mapping processes, system structure, and relationships between entities. GitHub Copilot 31,639installs multi-stage-dockerfile official github This skill guides GitHub Copilot in writing multi-stage Dockerfiles for different languages and frameworks. Use it when the final runtime image should contain fewer build dependencies. GitHub Copilot 29,688installs documentation-writer official github Skill that turns the agent into a technical writer following the Diátaxis framework: tutorials, how-to guides, reference, and explanation. Proposes structure before writing. GitHub Copilot 27,757installs prd official github Turns a feature idea into a structured PRD with user stories, technical requirements, and risks. Use it when planning a software feature or an AI-powered one. GitHub Copilot 24,035installs refactor official github This skill reshapes existing code without changing its external behavior. Use it for gradual cleanup of large functions, duplication, weak types, and code smells. GitHub Copilot 22,321installs java-springboot official github Gives GitHub Copilot Spring Boot development practices, from project layout to tests and security. Use it when writing or reviewing Java application code. GitHub Copilot 21,272installs create-readme official github This skill reviews a project and creates a structured README.md. Use it when the repository needs clear documentation based on its actual files and code. GitHub Copilot 19,081installs

Similar

bigquery-migration-sql-translator official google Translates SQL queries, DDL schemas, and procedures from Oracle, Snowflake, or Redshift to BigQuery GoogleSQL via BQMS. Fits database migration tasks. Claude Code Gemini CLI CX Codex 45installs clinical-research claude-code-skills Plan a prospective clinical study by selecting endpoints, estimating sample size, and checking feasibility before a phase-gate review. Claude Code 156installs xlsx official anthropics Creates, reads, edits, and converts spreadsheet files. Use it when the requested deliverable is an Excel workbook or another tabular file. Claude Code Claude.ai 187,223installs google-agents-cli-observability official Google This skill guides you through tracing and monitoring AI agents, including ADK agents. Use it when you need to inspect agent execution or monitor a deployed agent. Claude Code CX Codex Cursor +1 509,900installs caveman-evidence-review JuliusBrussee A read-only skill reviews Caveman Cloud evidence on LLM spend, traces, and routing. Use it to see where a project’s model budget goes. Claude Code CX Codex Cursor +1 103,500installs migration JuliusBrussee Enforces reversible, compatibility-safe transitions for schema, data, and API updates. Useful whenever data loss or rollout downtime is unacceptable. Claude Code CX Codex Cursor +1 102,900installs performance-optimization addyosmani An agent skill that measures before it changes code: Core Web Vitals budgets, N+1 queries, missing indexes and slow endpoints. Claude Code CX Codex Cursor +1 64,500installs supabase official supabase Guides the agent through database configuration and strict RLS policies in Supabase. CX Codex GP ChatGPT 8installs

Questions about qdrant-version-upgrade

How to install qdrant-version-upgrade in GitHub Copilot?

Run gh skill install github/awesome-copilot qdrant-version-upgrade or npx skills add github/awesome-copilot --skill qdrant-version-upgrade. You can also save the file to .github/skills/qdrant-version-upgrade/SKILL.md.

What does the qdrant-version-upgrade skill do?

It gives GitHub Copilot exact version compatibility rules, safe migration sequences between Qdrant and its SDK, and requirements for zero-downtime updates.

Can I skip a minor version when upgrading self-hosted Qdrant?

No, storage compatibility is guaranteed across only one minor version step. You must upgrade sequentially, though Qdrant Cloud automates multi-version jumps directly.

Source text

SKILL.md · MIT
---
name: qdrant-version-upgrade
description: "Guidance on how to upgrade your Qdrant version without interrupting the availability of your application and ensuring data integrity."
---


# Qdrant Version Upgrade

Qdrant has the following guarantees about version compatibility:

- Major and minor versions of Qdrant and SDK are expected to match. For example, Qdrant 1.17.x is compatible with SDK 1.17.x.

- Qdrant is tested for backward compatibility between minor versions. For example, Qdrant 1.17.x should be compatible with SDK 1.16.x. Qdrant server 1.16.x is also expected to be compatible with SDK 1.17.x, but only for the subset of features that were available in 1.16.x.

- For migration to the next minor version, it is recommended to first upgrade the SDK to the next minor version and then upgrade the Qdrant server.

- Storage compatibility is only guaranteed for one minor version. For example, data stored with Qdrant 1.16.x is expected to be compatible with Qdrant 1.17.x. If you need to migrate more than one minor version, it is required do the upgrade step by step, one minor version at a time. For example, to migrate from 1.15.x to 1.17.x, you need to first upgrade to 1.16.x and then to 1.17.x. Note: Qdrant Cloud automates this process, so you can directly upgrade from 1.15.x to 1.17.x without intermediate steps.

- A Qdrant cluster with a replication factor of 2 or higher can be upgraded without downtime by performing a rolling upgrade. This means that you can upgrade one node at a time while the other nodes continue to serve requests. This allows you to maintain availability of your application during the upgrade process. More about replication factor: [Replication factor](https://search.qdrant.tech/md/documentation/operations/distributed_deployment/?s=replication-factor)

For managing Qdrant version upgrades in Qdrant Cloud, you can use the [qcloud](https://github.com/qdrant/qcloud-cli) CLI tool.

© github · MIT · github/awesome-copilot

See also

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor