CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

cloudflare-vectorize

Cloudflare Vectorize vector database for semantic search and RAG. Use for vector indexes, embeddings, similarity search, or encountering dimension mismatches, filter errors.

65

Quality

82%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

75%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, well-structured skill body: commands, config, types, and a complete RAG example are all copy-paste ready, and the reference bundle is properly wired into the body with clear load conditions. The main costs are redundancy (dimensions and metadata rules repeated multiple times, marketing stats, dated versions) and four cited template files missing from the bundle.

Suggestions

Deduplicate repeated content: state embedding-model dimensions and metadata-key rules once (the Embedding Generation table and Metadata sections) and have Error 2/Error 3 cross-reference them instead of restating them; remove the duplicated template list and the repeated status/Token Savings block in the header and footer.

Drop or move unverifiable marketing metrics ('Token Savings: ~65%', 'Errors Prevented: 8', 'Dev Time Saved') and time-sensitive version pins ('wrangler@4.81.0', 'Last Updated') into a single versioning/deprecated section or the referenced docs, since they consume tokens and will age.

Fix the broken progressive-disclosure pointers: either add the four cited `templates/*.ts` files to the bundle or remove the 'Templates Included'/'See templates/document-ingestion.ts' references; also add an explicit pre-insert verification step (e.g., `wrangler vectorize info` to confirm metadata indexes exist) to strengthen workflow validation.

DimensionReasoningScore

Conciseness

Mostly efficient — tables and code are dense — but there is real redundancy: embedding-model dimensions appear three times (Index Configuration, Embedding Generation table, Error 2), metadata-key rules twice (Metadata Best Practices and Error 3), the template list twice, and setup stats are repeated in the header and footer. Unverifiable marketing claims ('Token Savings: ~65%', 'Errors Prevented: 8', 'Dev Time Saved: ~3 hours') and dated version pins ('wrangler@4.81.0', 'Last Updated: 2025-11-21') add padding that could be trimmed, matching 'mostly efficient but includes some unnecessary explanation or could be tightened' rather than anchor 4.

3 / 5

Actionability

Fully executable guidance throughout: exact wrangler commands with flags, a complete wrangler.jsonc binding config, TypeScript interface definitions, a copy-paste-ready RAG worker covering the most common use case, and precise operator/limit tables. It matches 'copy-paste ready code or commands; specific examples cover the common cases', and is not anchor 4 since there are no meaningful gaps in the main-path examples.

5 / 5

Workflow Clarity

The critical setup sequence is explicit and correctly ordered ('MUST DO BEFORE INSERTING VECTORS': create index → create metadata indexes → insert), with a 'Why' explaining the ordering constraint and an eight-item error/solution catalog serving as feedback loops. It falls short of anchor 5 because there is no explicit verification checkpoint (e.g., confirm metadata indexes exist via `wrangler vectorize info` before inserting) — validation of the risky pre-insert step is implicit.

4 / 5

Progressive Disclosure

Structure is genuinely good: seven one-level-deep reference files that all exist in the bundle, each clearly signaled with 'Load references/...' plus a 'When to Load References' navigation table. However, the body points to four `templates/*.ts` files (basic-search.ts, rag-chat.ts, document-ingestion.ts, metadata-filtering.ts) that do not exist in the bundle — broken navigation pointers that keep it at 'minor organization gaps' rather than anchor 5.

4 / 5

Total

16

/

20

Passed

Description

83%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 strong description: it states the domain concisely in third person, includes explicit 'Use for...' trigger guidance with concrete error conditions, and stays tightly scoped to Cloudflare Vectorize. Its only weaknesses are minor — a few natural synonyms are missing from the description field and it describes capability areas rather than enumerate full action coverage.

DimensionReasoningScore

Specificity

The description names the domain ('Cloudflare Vectorize vector database for semantic search and RAG') and several concrete capability areas plus specific error conditions ('vector indexes, embeddings, similarity search, or encountering dimension mismatches, filter errors'), but stops short of listing comprehensive actions like create/manage/query operations, so it sits at 'several specific actions; minor gaps' rather than the comprehensive anchor.

4 / 5

Completeness

It explicitly answers both questions: the first sentence states what the skill is for, and 'Use for vector indexes, embeddings, similarity search, or encountering dimension mismatches, filter errors' provides concrete trigger phrases mirroring the anchor-5 example pattern. Not 4, because the 'when' is explicit and names specific triggering conditions rather than being merely present-but-imprecise.

5 / 5

Trigger Term Quality

'vector indexes', 'embeddings', 'similarity search', 'dimension mismatches', and 'filter errors' are phrases users would naturally say when needing this skill, but common synonyms and variations ('vector search', 'knn', 'query vectors', 'RAG pipeline') are absent from the description field itself, matching 'good keyword coverage; a few natural terms missing'.

4 / 5

Distinctiveness Conflict Risk

'Cloudflare Vectorize' is a clearly named niche product with distinct triggers, giving a clear niche; the broad term 'embeddings' creates minor overlap risk with general embedding-generation skills, so it fits 'mostly distinct; minor overlap risk' rather than minimal-conflict anchor 5.

4 / 5

Total

17

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

Total

14

/

16

Passed

Repository

secondsky/claude-skills

Path

plugins/cloudflare-vectorize/skills/cloudflare-vectorize/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.