qdrant-edge — скилл для Claude Code: возможности и установка
Скилл для Claude Code помогает разрабатывать приложения на Qdrant Edge. Разбирает синхронизацию локального шарда, поиск BM25 и обслуживание индексов.
Apache-2.0 328 установок ★ 271 обновлён 2026-11-11
npx skills add qdrant/skills --skill qdrant-edge -a claude-codeЧто делает qdrant-edge
Скилл объясняет, как устроен встроенный в приложение шард Qdrant Edge и какие операции уже доступны: BM25, применение снимков, фасетный поиск и подсчёт записей. Для синхронизации с сервером готового вызова .sync() нет: транспорт и отправку локальных изменений нужно собрать самостоятельно.
В руководстве описаны обновление шарда через снимки, частичные снимки и объединение векторов с полнотекстовым поиском. Для плотных эмбеддингов требуется отдельный пакет fastembed; сам Edge работает с Python и Rust. После массовой записи нужно вызвать optimize, иначе новые точки ищутся перебором. Edge пока в бета-версии, поэтому версию придётся фиксировать: API меняется между релизами.
Также скилл помогает использовать unpack_snapshot и update_from_snapshot, не обрабатывая сегменты вручную. Edge работает на одном узле; распределённый поиск требует другого решения.
Какие задачи решает
- синхронизировать локальный шард с серверным снимком
- настроить BM25-поиск по полям payload
- объединить результаты векторного и текстового поиска
- ускорить поиск после массовой записи вызовом
optimize - обновить шард частичным снимком
Примеры запросов агенту
- Объясни, как обновлять локальный Qdrant Edge из снимка сервера.
- Покажи, как настроить BM25-поиск по полю payload в Edge.
- Как объединить плотный векторный поиск и полнотекстовый запрос в Edge?
Как установить qdrant-edge
1Через Skills CLI (Vercel)
npx skills add qdrant/skills --skill qdrant-edge -a claude-code2Вручную: положить файлы
~/.claude/skills/qdrant-edge/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/qdrant-edge/
1Через Skills CLI (Vercel)
npx skills add qdrant/skills --skill qdrant-edge -a codex2Вручную: положить файлы
.agents/skills/qdrant-edge/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add qdrant/skills --skill qdrant-edge -a cursor2Вручную: положить файлы
.cursor/skills/qdrant-edge/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install qdrant/skills skills/qdrant-edge2Вручную: положить файлы
.github/skills/qdrant-edge/SKILL.md1Через Skills CLI (Vercel)
npx skills add qdrant/skills --skill qdrant-edge -a gemini-cli2Командой платформы
gemini skills install https://github.com/qdrant/skills --path skills/qdrant-edgeВручную: положить файлы
.devin/skills/qdrant-edge/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add qdrant/skills --skill qdrant-edge -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о qdrant-edge
Как установить qdrant-edge в Claude Code?
Выполните npx skills add qdrant/skills --skill qdrant-edge -a claude-code. Скилл будет доступен по пути ~/.claude/skills/qdrant-edge/SKILL.md.
Что делает qdrant-edge?
Скилл объясняет разработку на Qdrant Edge: синхронизацию снимками, BM25 и гибридный поиск, а также обслуживание шарда.
Как синхронизировать Edge с сервером?
В Edge нет готового .sync(): нужно самостоятельно организовать загрузку снимка и транспорт. Для обновлений можно применять частичные снимки через snapshot_manifest, unpack_snapshot и update_from_snapshot.
Исходный текст
SKILL.md · Apache-2.0
--- name: qdrant-edge description: "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 on device', 'Edge snapshots', 'apply a partial snapshot', 'why is my Edge search slow after inserts', or is writing custom sync, BM25, or fusion code against qdrant-edge. Also use when deciding what Edge ships built-in versus what you must implement." --- # Building on Qdrant Edge Edge is the Qdrant engine embedded in your process (Python or Rust), not a thin local vector store to wrap. The failure mode is rebuilding what the shard already ships: keyword scoring, snapshot apply, faceting, counting. Before writing any of that, check the shard API. One thing Edge does NOT give you is a one-call cloud sync, so knowing what is built in keeps you from both reinventing built-ins and expecting capabilities Edge lacks. Edge is single-node and shares the server's data format. - Edge is in beta: pin your version, the API drifts between releases [Qdrant Edge](https://skills.qdrant.tech/md/documentation/edge/). ## Syncing a Shard with a Qdrant Server Use when: seeding a shard from a server, keeping it fresh, backing it up, or aggregating many devices into one collection. There is no built-in `.sync()`. Sync is a pattern you assemble from shard helpers plus your own transport, so do not go looking for one call. - Follow the documented dual-shard pattern: a `mutable` shard for local writes plus an `immutable` shard restored from a server snapshot, query both, refresh on a schedule [Edge synchronization guide](https://skills.qdrant.tech/md/documentation/edge/edge-synchronization-guide/). - You write the snapshot download (plain HTTP to the shard snapshot endpoint), then apply it with `unpack_snapshot` and `update_from_snapshot`. Do not untar or merge segments by hand [Synchronization patterns](https://skills.qdrant.tech/md/documentation/edge/edge-data-synchronization-patterns/). - Refresh incrementally with a partial snapshot built from `snapshot_manifest`, not a full snapshot every cycle [Synchronization patterns](https://skills.qdrant.tech/md/documentation/edge/edge-data-synchronization-patterns/). - Push is your own dual-write: on each local upsert, enqueue the point and let a background worker upsert it to the server, buffering while offline [Synchronization patterns](https://skills.qdrant.tech/md/documentation/edge/edge-data-synchronization-patterns/). ## Keyword and Hybrid Search on Device Use when: you need exact-term or BM25 matching, alone or alongside vectors. - BM25 is built into Edge: create a full-text index with `scoring` enabled on the payload field (with the stemmer and stopwords for your language) and rank with a `TextQuery`. It needs no embedding model and derives document lengths from your data. Do not ship a second BM25 library [Edge BM25](https://skills.qdrant.tech/md/documentation/edge/edge-bm25/) - Need sparse BM25 vectors instead, for example to match a server collection that uses sparse vector BM25? Edge's BM25 embedder (`Bm25` in Python, `EdgeBm25` in Rust) produces server-compatible sparse vectors: `embed_document` for documents, `embed_query` for queries [Edge BM25](https://skills.qdrant.tech/md/documentation/edge/edge-bm25/) - Dense embeddings are NOT in Edge: generate them on device with the separate `fastembed` package [FastEmbed embeddings](https://skills.qdrant.tech/md/documentation/edge/edge-fastembed-embeddings/) - For hybrid search, run the dense and keyword legs as `prefetches` (a `TextQuery`, or a sparse vector query) and fuse them with a `Fusion` query in a single `query` call, instead of combining rankings in application code [Reading data](https://skills.qdrant.tech/md/documentation/edge/edge-api/reading-data/) ## Operating the Shard Use when: writes have accumulated, search is slow after inserts, or a backup is larger than the data. - Edge has NO background optimizer. Call `optimize` after bulk writes: it builds indexes and reclaims deleted points. Until then, new points are searched by brute force [Edge quickstart](https://skills.qdrant.tech/md/documentation/edge/edge-quickstart/) - Faceting, counting, and enumeration are built in (`facet`, `count`, `scroll`); index the fields you filter or facet with `create_field_index` rather than aggregating in application code [Edge quickstart](https://skills.qdrant.tech/md/documentation/edge/edge-quickstart/) - The write-ahead log is pre-allocated to 32 MB and inflates apparent disk and backup size. Shrink it with `wal_options` (Rust), and do not treat raw file size as real usage [Edge quickstart](https://skills.qdrant.tech/md/documentation/edge/edge-quickstart/) ## What NOT to Do - Expect a bidirectional `.sync()` or a built-in push path: Edge gives you snapshot apply, you own the transport and the dual-write - Untar or merge snapshot segments by hand instead of using `unpack_snapshot` and `update_from_snapshot` - Ship a custom or third-party BM25 when Edge has one built in - Run a `TextQuery` on a full-text index created without `scoring`: BM25 ranking needs it enabled - Use the BM25 embedder's `embed_document` for queries or `embed_query` for documents: the weighting differs and results go wrong - Combine dense and keyword rankings in application code: Edge `query` accepts `prefetches` and fuses them with a `Fusion` query - Assume a background optimizer like the server's: nothing is indexed or compacted until you call `optimize` - Reach for Edge when you need distributed or multi-node search: it is single-node [Qdrant Edge](https://skills.qdrant.tech/md/documentation/edge/) - Claim support for a language beyond Python and Rust, or an OS or accelerator the Edge docs do not state
© qdrant · Apache-2.0 · qdrant/skills