vector-retrieval

Retrieve top-k passages from a local corpus by vector similarity with scores.

Updated Sep 11, 2026
One-click install
npx skills add https://github.com/JYeswak/grok_bot_playground --skill vector-retrieval-jyeswak
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: vector-retrieval
Source: https://github.com/JYeswak/grok_bot_playground/tree/main/plugin/skills/vector-retrieval
Command: npx skills add https://github.com/JYeswak/grok_bot_playground --skill vector-retrieval-jyeswak

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Answering questions from a local document corpus requires finding the most relevant passages, and a ranked list without similarity scores hides weak matches and manufactures false confidence in the answer. ## Core Features & Use Cases - Top-k similarity retrieval: Embed a query the same way the corpus was embedded, score every passage, and return the top k (default 5) ordered by score descending. - Score-transparent reporting: Every hit carries its numeric score on one shared scale, with weak hits labeled weak and near-duplicates flagged rather than double-counted. - Corpus-gap honesty: When the top score falls below a stated floor, the skill reports that the corpus does not contain the answer instead of dressing up the least-bad passage. - Use Case: Ask what your team's internal documentation says about a deployment rollback policy and receive a ranked list of the five most similar passages with scores, sources, and a verdict on whether the corpus actually answers the question. ## Quick Start Ask what the local corpus says about a specific question and request the top five matching passages with their similarity scores and sources.

Frequently Asked Questions about vector-retrieval

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I find what a local document corpus says about a question?

Restate the question as a single retrieval query, embed it the same way the corpus was embedded, and score every passage by similarity. Return the top k passages (default 5) ordered by score descending, each with its source and score.

How do I rank candidate passages before drafting an answer?

Run top-k vector retrieval over the corpus and report rank, passage excerpt, similarity score, and source for each hit. Check that the top score clears a stated floor before treating the corpus as containing the answer.

Can I compare similarity scores across different embedding models?

No. Query and corpus must share one embedder, because mixed embedders make scores incomparable. Never compare scores across different embedders or corpora as if they were one ranking.

What does a low top similarity score mean in vector retrieval?

A low top score means the corpus does not contain the answer. Report that gap directly instead of presenting the least-bad passage as a finding, and label any hit below your stated floor as weak.

What are the limitations of vector similarity retrieval?

It is read-only and cannot edit, re-embed, send, or publish. Community chunk sizes, k values, and score thresholds are unverified claims until measured against your own corpus, and unreachable corpora must be recorded rather than accessed by improvisation.