CtrlK
BlogDocsLog inGet started
Tessl Logo

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.

62

Quality

73%

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 ./skills/vector-index-tuning/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

63%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 compact, well-structured skill body with a clear use/don't-use framing and a sensible sequenced workflow. Its main weaknesses are non-executable guidance and a referenced resource file that is missing from the bundle.

Suggestions

Add the missing resources/implementation-playbook.md (or remove the broken reference) so the in-body pointers resolve to real files; keep a single reference instead of duplicating it across Instructions and Resources.

Make the Instructions more actionable by naming concrete benchmarking tools/commands and example parameter sweep ranges for HNSW (e.g., efConstruction, M, efSearch) and quantization (PQ/SQ).

Turn the benchmark step into an explicit feedback loop (sweep -> measure recall/latency -> adjust -> re-measure) and surface a recall-regression revert checkpoint inside the workflow rather than only in Safety.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence with no concept over-explanation, but the playbook reference is stated twice (Instructions and Resources sections), a minor redundancy that could be trimmed.

4 / 5

Actionability

Steps name concrete artifacts ('track recall, latency, and memory', 'parameter sweeps', 'staging dataset') but provide no executable commands, tool names, or parameter ranges, leaving the guidance high-level for a tuning task.

3 / 5

Workflow Clarity

Steps 1-4 are clearly sequenced with a staging validation checkpoint (step 4) plus revert/rollback guidance in Safety, but the benchmarking loop is implied rather than an explicit validate-fix-retry feedback loop.

4 / 5

Progressive Disclosure

Sections are well organized, but the body twice references 'resources/implementation-playbook.md', a file that does not exist in the bundle (no resources/ directory), so the one-level-deep reference is broken and duplicated rather than clearly navigable.

3 / 5

Total

14

/

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, well-targeted description that clearly states both capability and trigger conditions with concrete, domain-specific language. It is concise without being vague and stays in appropriate third-person voice.

DimensionReasoningScore

Specificity

Lists three concrete actions — 'tuning HNSW parameters, selecting quantization strategies, or scaling vector search infrastructure' — plus the three optimization axes (latency, recall, memory), giving several specific actions with only minor coverage gaps (e.g., index type selection, reindexing).

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.

5 / 5

Trigger Term Quality

Natural terms a tuning user would say are present ('HNSW parameters', 'quantization', 'vector search', 'latency', 'recall'), but common synonyms like 'ANN' or 'approximate nearest neighbor' are missing, so it is good but not comprehensive.

4 / 5

Distinctiveness Conflict Risk

Vector index tuning is a clear niche with distinct triggers (HNSW, quantization), but it could overlap with broader retrieval/database-tuning skills, so risk is minimal but not absent.

4 / 5

Total

17

/

20

Passed

Validation

100%

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

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
rmyndharis/antigravity-skills
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.