CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

qdrant-vector-search

High-performance vector similarity search engine for RAG and semantic search. Use when building production RAG systems requiring fast nearest neighbor search, hybrid search with filtering, or scalable vector storage with Rust-powered performance.

56

Quality

71%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./backend/cli/skills/llm-tools/qdrant/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

57%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A highly actionable, code-dense reference for Qdrant with a clear getting-started path and genuine one-level-deep bundle references. Its weaknesses are length and duplication with the reference files, marketing padding, and the complete absence of validation/verification checkpoints for batch operations.

Suggestions

Move advanced topics that duplicate the bundle (quantization, multi-vector support, production deployment, performance tuning, Common issues) into references/advanced-usage.md and references/troubleshooting.md, leaving concise pointers in SKILL.md.

Add validation checkpoints for batch operations, e.g. after upsert verify with info = client.get_collection(name) and check points_count before proceeding to search.

Trim marketing padding — the 'Key features' bullet list ('Rust-powered: Memory-safe, high performance') and star counts in Resources — and make the truncated snippets complete (define dense_embedding/client, expand ScalarQuantization(...)).

DimensionReasoningScore

Conciseness

Most content is Qdrant-specific and not already known to Claude, but there is measurable padding: marketing-style feature bullets ('Rust-powered: Memory-safe, high performance'), a Resources section with star counts ('22k+ stars'), and a 'Common issues' section that duplicates references/troubleshooting.md. This fits 'mostly efficient but includes some unnecessary explanation or could be tightened' rather than the minor-trim 4 anchor.

3 / 5

Actionability

Provides extensive concrete, mostly copy-paste-ready code across create_collection, upsert, Filter/must/must_not filtering, named/sparse vectors, quantization, and payload indexing. Minor gaps prevent a 5: placeholder vectors ('[0.1, 0.2, ...]'), undefined variables (dense_embedding, sparse_embedding, and client in the LlamaIndex snippet), and an elided 'ScalarQuantization(...)' in the Common issues section — consistent with 'mostly executable guidance with minor gaps'.

4 / 5

Workflow Clarity

The Quick start sequence (install -> connect -> create collection -> upsert -> search) is clear, but there are no validation or verification checkpoints anywhere: no check that points landed (e.g. get_collection counts), no error handling after batch upserts or bulk loads. The rubric caps workflow clarity at 3 for batch operations without validation, which applies to the upsert/batch-search guidance here.

3 / 5

Progressive Disclosure

Two one-level-deep references exist and are clearly signaled with descriptions ('Advanced Usage - Distributed mode, hybrid search, recommendations'), but the ~480-line body inlines substantial advanced material (quantization, multi-vector support, payload indexing, production deployment, performance tuning, Common issues) that overlaps the 648-line advanced-usage.md and 631-line troubleshooting.md. This matches 'some structure; content that should be separate is inline' rather than the well-split 4 anchor.

3 / 5

Total

13

/

20

Passed

Description

75%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A well-formed description with an explicit 'Use when' clause and strong natural trigger terms. Its main weaknesses are buzzword padding in place of concrete operations, missing common synonyms like 'embeddings' and 'vector database', and the absence of the tool's name, which creates overlap risk with other vector-database skills.

Suggestions

Replace buzzword padding ('High-performance', 'Rust-powered performance') with concrete operations, e.g. 'Create vector collections, upsert points with payload, run filtered nearest-neighbor search, and apply quantization for large-scale RAG pipelines.'

Add common natural terms users would say: 'embeddings', 'vector database', 'vector search', and 'similarity search' as synonyms in the trigger clause.

Name Qdrant explicitly (or a unique differentiator beyond 'Rust-powered') so the description does not collide with Chroma/Weaviate/Pinecone skills covering the same RAG triggers.

DimensionReasoningScore

Specificity

Names the domain ('vector similarity search engine for RAG and semantic search') and a few capabilities ('fast nearest neighbor search, hybrid search with filtering, scalable vector storage'), but these are framed as use-cases rather than concrete operations, and the phrasing is padded with buzzwords ('High-performance', 'Rust-powered performance'). It falls between the 1-2-concrete-actions anchor and the several-specific-actions anchor, but the buzzword padding and absence of core operations (create collections, upsert, filtered retrieval) keep it from a 4.

3 / 5

Completeness

Explicitly answers both questions: the 'what' ('High-performance vector similarity search engine for RAG and semantic search') and the 'when' via a concrete 'Use when building production RAG systems requiring fast nearest neighbor search, hybrid search with filtering, or scalable vector storage' clause with three specific triggers. This matches the top anchor; a 4 would require a vaguer or less specific 'when' clause.

5 / 5

Trigger Term Quality

Includes natural phrases users would actually say: 'RAG', 'semantic search', 'nearest neighbor search', 'hybrid search', 'vector storage', 'vector similarity search'. A few common variations are missing — notably 'embeddings', 'vector database', and the bare phrase 'vector search' — which fits the 'good keyword coverage; a few natural terms missing' anchor rather than the comprehensive 5.

4 / 5

Distinctiveness Conflict Risk

The description never names Qdrant, and its trigger phrases ('production RAG systems', 'semantic search', 'scalable vector storage') apply equally to sibling vector-database skills like Chroma, Weaviate, or Pinecone. 'Rust-powered performance' is the only distinguishing hint, so it fits 'somewhat specific but could still overlap with similar skills' rather than the mostly-distinct 4.

3 / 5

Total

15

/

20

Passed

Validation

81%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (503 lines); consider splitting into references/ and linking

Warning

metadata_version

'metadata.version' is missing

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

13

/

16

Passed

Repository

synthetic-sciences/openscience

Path

backend/cli/skills/llm-tools/qdrant/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.