CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

faiss

Facebook's library for efficient similarity search and clustering of dense vectors. Supports billions of vectors, GPU acceleration, and various index types (Flat, IVF, HNSW). Use for fast k-NN search, large-scale vector retrieval, or when you need pure similarity search without metadata. Best for high-performance applications. Also covers Chroma and Qdrant (guides in references/).

Quality

77%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Critical

Do not install without reviewing

Fix and improve this skill with Tessl

tessl review fix ./skills/rag/faiss/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

65%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 lean, code-first cookbook that covers the practical FAISS surface (index types, GPU, persistence, integrations) with mostly runnable examples. The main gaps are the absence of validation/feedback loops in index-building workflows, incomplete integration snippets, and a broken progressive-disclosure structure where the dedicated FAISS index-types guide is orphaned from SKILL.md.

Suggestions

Link references/index_types.md from the Index types section (e.g., 'See references/index_types.md for the complete selection guide') and trim the inline per-index snippets, so the existing deep-dive file is actually discoverable.

Add explicit validation checkpoints to index workflows: check `index.is_trained` before `add()`, and suggest verifying recall of approximate indexes (IVF/PQ/HNSW) against a ground-truth Flat search on a sample of queries.

Make integration examples complete and safe: define `docs` in the LangChain example, finish the LlamaIndex snippet with a search call, and add a one-line caution about `allow_dangerous_deserialization=True` only being safe on locally created indexes.

DimensionReasoningScore

Conciseness

Mostly lean, code-first content with minimal conceptual explanation ('# L2 distance', '# No training needed' style comments only). Not 5: the 'Metrics' block (GitHub stars, 'C++ with Python bindings') and Resources section are trivia, and ~60 lines of inline per-index detail duplicate the dedicated references/index_types.md guide.

4 / 5

Actionability

Mostly executable, copy-paste-ready snippets covering installation, all four index types, save/load, and GPU transfer. Not 5: the LangChain example references an undefined `docs` variable, and the LlamaIndex snippet is a fragment that builds a vector store without showing usage.

4 / 5

Workflow Clarity

Sequences (train → add → search) exist only implicitly inside code examples with no explicit checkpoints or error-recovery loops — e.g., no `index.is_trained` verification before `add()`, and `allow_dangerous_deserialization=True` is used with no caution. Matches 'sequence present but checkpoints missing or implicit' rather than 4's 'most checkpoints present'.

3 / 5

Progressive Disclosure

The Chroma/Qdrant table is clearly signaled with descriptive links (both target files exist), but the core deep-dive references/index_types.md (280 lines) is never referenced from SKILL.md, making it undiscoverable, and the inline Index types section duplicates content that should live there. Qdrant's overview also chains to a second nesting level. This fits 'references present but not clearly signaled; content that should be separate is inline' better than 4's 'references mostly clear'.

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 description with a clear what statement, an explicit 'Use for...' trigger clause naming concrete use cases, and specific capability coverage. The main weaknesses are the vague 'Best for high-performance applications' filler and the appended Chroma/Qdrant coverage, which increases overlap risk with sibling vector-store skills.

DimensionReasoningScore

Specificity

Lists several concrete capabilities — 'similarity search and clustering of dense vectors', 'fast k-NN search', 'large-scale vector retrieval', GPU acceleration, index types (Flat, IVF, HNSW) — with only minor gaps. Not 5 because 'Best for high-performance applications' is generic filler rather than a concrete action.

4 / 5

Completeness

Explicitly answers both: what ('Facebook's library for efficient similarity search and clustering of dense vectors. Supports billions of vectors, GPU acceleration, and various index types') and when ('Use for fast k-NN search, large-scale vector retrieval, or when you need pure similarity search without metadata') with concrete trigger phrases. Third-person voice, no padding beyond one filler clause.

5 / 5

Trigger Term Quality

Good natural-term coverage: 'similarity search', 'k-NN search', 'vector retrieval', 'dense vectors', 'GPU acceleration'. Falls short of 5 because common user phrases like 'nearest neighbor search', 'vector database', and 'embeddings' are missing.

4 / 5

Distinctiveness Conflict Risk

'Pure similarity search without metadata' plus tool-specific index names carve a clear niche distinct from full vector databases. Not 5 because 'Also covers Chroma and Qdrant' broadens the trigger surface and could pull queries intended for dedicated Chroma/Qdrant skills.

4 / 5

Total

17

/

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

frontmatter_unknown_keys

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

Warning

relative_links

Relative link issues: 2 deeper-than-1-level

Warning

referenced_paths_exist

Referenced path issues: 2 deeper-than-1-level

Warning

Total

13

/

16

Passed

Repository

OpenLAIR/dr-claw

Path

skills/rag/faiss/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.