CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

qdrant

Vector search engine for production RAG systems.

51

Quality

64%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

High

Do not use without reviewing

Fix and improve this skill with Tessl

tessl review fix ./optional-skills/mlops/qdrant/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

68%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.

This is a strong, action-dense reference: current-API executable examples, useful tables, and real one-level-deep reference files. The main gaps are the total absence of validation/verification steps for database batch operations (capping workflow clarity) and advanced topics inlined in the body that belong in the existing advanced-usage.md bundle file.

Suggestions

Add explicit validation checkpoints around batch operations, e.g. after upsert verify with client.count(collection_name) or get_collection(...) points_count, and a smoke-test query before declaring ingestion complete; this lifts the workflow_clarity cap.

Move the Quantization, Multi-vector, and Production deployment/performance-tuning sections into references/advanced-usage.md (linked from the References section) to keep SKILL.md a lean overview.

Replace placeholder code (vectors like [0.1, 0.2, ...], undefined query_embedding, ScalarQuantization(...)) with runnable constants or a one-line 'replace with your embedding' note so examples are copy-paste ready.

Drop or shrink the in-body 'Common issues' section since it duplicates references/troubleshooting.md.

DimensionReasoningScore

Conciseness

The body is almost entirely executable code, tables, and terse bullet lists with no conceptual padding Claude already knows, fitting 'Efficient; minor instances of over-explanation that could be trimmed'. Not 5 because the 'Common issues' section duplicates content already in references/troubleshooting.md, and the 'When to use' / alternatives and LangChain/LlamaIndex snippets add length without proportional value.

4 / 5

Actionability

Nearly all sections give concrete, runnable Python with correct current APIs (query_points, query_batch_points, named vectors via `using`), matching 'Mostly executable guidance; concrete code or commands with minor gaps'. Not 5 because several examples are non-copy-paste: placeholder vectors like `[0.1, 0.2, ...]`, an undefined `query_embedding`, and a literal `ScalarQuantization(...)` ellipsis.

4 / 5

Workflow Clarity

The Quick start gives a coherent install → connect → create collection → upsert → search sequence, but there are no validation checkpoints or feedback loops anywhere (no collection-existence check, no upsert verification, no search smoke test), and the scoring note caps workflow clarity at 3 for database/batch operations without validation. Not 4 because 'most checkpoints present' is explicitly not met — none are present.

3 / 5

Progressive Disclosure

Both bundle files exist, are one level deep, and are clearly signaled with descriptions in the References section, and the body keeps quick-start/core operations inline — fitting 'Good structure; most content appropriately placed; references mostly clear; minor organization gaps'. Not 5 because clearly advanced material (quantization, multi-vector/hybrid search, production deployment, performance tuning) is inlined in the body rather than split into the existing advanced-usage.md, making the overview heavier than ideal.

4 / 5

Total

15

/

20

Passed

Description

48%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.

The description identifies a clear niche but is a minimal noun phrase: it answers 'what' with no concrete actions, no 'when to use' trigger guidance, and a narrow keyword set. Adding a Use-when clause, concrete capability verbs, and common synonyms (vector database, semantic search, embeddings) would lift all four dimensions.

Suggestions

Add an explicit trigger clause, e.g. 'Use when building RAG pipelines, semantic search, or recommendation systems that need vector storage and filtered similarity search.'

List concrete actions instead of a bare noun phrase, e.g. 'Store dense/sparse vector embeddings, run filtered and hybrid similarity search, and scale vector collections in production.'

Include natural synonyms and product keywords users would actually say — 'vector database', 'semantic search', 'embeddings', 'similarity search', 'Qdrant' — to improve trigger-term coverage and distinctiveness.

DimensionReasoningScore

Specificity

The description "Vector search engine for production RAG systems" names the domain clearly but contains zero concrete actions — it is a bare noun phrase, matching the anchor 'Names the domain but actions are minimal or generic'. A 3 would require 1-2 concrete actions (e.g., 'store, search, and filter vector embeddings'), which are absent; a 1 would be entirely vague with no domain identification.

2 / 5

Completeness

The 'what' is clear (a vector search engine for production RAG), but there is no 'Use when...' clause or equivalent trigger guidance at all, which caps completeness at 3 per the judging guidelines. A 4 requires an explicit but less specific 'when'; this has none.

3 / 5

Trigger Term Quality

It includes relevant keywords users would say — "vector search", "RAG", "production" — but misses common variations and synonyms such as "vector database", "semantic search", "embeddings", "similarity search", and the product name "Qdrant" (present only in frontmatter metadata, not the description). This matches 'Some relevant keywords but missing common variations or synonyms' rather than 4's 'a few natural terms missing' breadth.

3 / 5

Distinctiveness Conflict Risk

The niche is fairly specific — vector search for production RAG — and would not trigger for generic document or data tasks, fitting 'Mostly distinct; minor overlap risk with closely related skills'. Not a 5 because it lacks distinctive trigger phrases and could still collide with closely related vector-database skills (Pinecone, Weaviate, Chroma) that the body itself lists as alternatives.

4 / 5

Total

12

/

20

Passed

Validation

75%

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

Validation — 12 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

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

Warning

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

frontmatter_unknown_keys

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

Warning

Total

12

/

16

Passed

Repository

NousResearch/hermes-agent

Path

optional-skills/mlops/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.