CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

vector-index-tuning

Optimize vector index performance for latency, recall, and memory. Use when tuning HNSW parameters, selecting quantization strategies, or scaling vector search infrastructure.

60

Quality

76%

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 ./plugins/AI-Agents-Safe-Coding-Skills/skills/vector-index-tuning/SKILL.md

The canonical home for this skill is vector-index-tuning in rmyndharis/antigravity-skills

SKILL.md
Quality
Evals
Security

Quality

Content

56%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 concise, well-structured overview with a sound high-level workflow and appropriate safety guidance, but it delegates all concrete detail to a playbook file that is missing from the bundle, leaving the body with vague, non-executable instructions. Fixing the dangling resource reference and inlining key specifics (parameter names, benchmark commands) would raise both actionability and progressive disclosure.

Suggestions

Fix the dangling reference: `resources/implementation-playbook.md` is referenced in both Instructions and Resources but no such file (or resources/ directory) exists in the bundle — either ship the playbook or remove/correct the pointer.

Add concrete, executable guidance to the Instructions: name the actual HNSW parameters to sweep (e.g., M, ef_construction, ef_search), quantization options (PQ, SQ, binary), and a specific benchmark command or recall-evaluation snippet instead of 'Benchmark parameter sweeps using real queries'.

Add an error-recovery feedback loop to the workflow, e.g., 'if recall falls below target, increase ef_search and re-benchmark before considering a higher-accuracy index type', and remove the duplicated resource line (it appears verbatim in both Instructions and Resources).

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence: no concept explanations, short bullet sections ("Tuning HNSW parameters", "Balancing recall vs speed"), and terse instructions. The one trim candidate is the duplicated resource pointer — "Refer to `resources/implementation-playbook.md` for detailed patterns, checklists, and templates" in Instructions is repeated verbatim as the Resources entry — which keeps it just below the 5 anchor's 'every token earns its place'.

4 / 5

Actionability

The instructions are high-level directives — "Choose an index type and establish a baseline with default parameters", "Benchmark parameter sweeps using real queries" — with no specific executable detail: no parameter names (e.g., M, ef_construction, ef_search), no commands or code, no benchmarking method or tool. This matches the 2 anchor ("high-level hints but missing the specific steps to execute") rather than 3, since not even pseudocode-level specifics or key concrete details are given, and the detail is delegated to a playbook file that is not present in the bundle.

2 / 5

Workflow Clarity

The numbered sequence (gather targets → baseline → benchmark sweeps → staging validation → rollout) is clear and logical, and validation checkpoints are present: "Validate changes on a staging dataset before rolling out to production", "revert if quality drops", and "Avoid reindexing in production without a rollback plan". It falls short of the 5 anchor because there are no error-recovery feedback loops inside the workflow itself (e.g., what to adjust when recall misses target) — the sequence and checkpoints otherwise match the 4 anchor well.

4 / 5

Progressive Disclosure

Sections are well organized and the reference is clearly signaled ("Refer to `resources/implementation-playbook.md`"), but the referenced file does not exist anywhere in the bundle — no references/, scripts/, assets/, or resources/ directory is present. The skill delegates all 'detailed patterns, checklists, and templates' to a dangling reference, so navigation to the detail content is broken; this sits between the 3 anchor (structure present, references problematic) and below the 4 anchor's 'references mostly clear', since a missing target is more than a minor organization gap.

3 / 5

Total

13

/

20

Passed

Description

87%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-crafted description in third-person voice that clearly states what the skill does and gives explicit, concrete 'Use when' triggers with natural domain keywords. Minor room to improve via additional synonyms (embeddings, ANN, specific vector DB names).

DimensionReasoningScore

Specificity

"Optimize vector index performance for latency, recall, and memory" plus "tuning HNSW parameters, selecting quantization strategies, or scaling vector search infrastructure" lists several specific concrete actions with named optimization targets (latency, recall, memory). It falls just short of the 5 anchor's comprehensive coverage because it omits related actions like benchmarking/evaluating recall or rebuilding indexes, and names no concrete systems (FAISS, pgvector, Milvus).

4 / 5

Completeness

It explicitly answers both: what ("Optimize vector index performance for latency, recall, and memory") and when ("Use when tuning HNSW parameters, selecting quantization strategies, or scaling vector search infrastructure") with concrete trigger phrases. This matches the 5 anchor; the 4 anchor's weaker/implicit 'when' does not apply since the trigger clause is explicit and specific.

5 / 5

Trigger Term Quality

Strong natural keywords a user would actually say: "HNSW parameters", "quantization", "vector search", "latency", "recall". A few common variations are missing — "embeddings", "ANN / approximate nearest neighbor", "vector database", and tool names like FAISS or pgvector — which keeps it below the 5 anchor's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

HNSW tuning and quantization selection form a clear niche with highly distinctive technical triggers that are unlikely to fire for the wrong skill. The only mild breadth is "scaling vector search infrastructure", which could minimally overlap with general infrastructure-scaling skills, but not enough to drop to the 4 anchor's 'minor overlap risk' characterization.

5 / 5

Total

18

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

plugins/AI-Agents-Safe-Coding-Skills/skills/vector-index-tuning/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.