librarian-library-search

Search Qdrant-backed libraries with semantic vector queries and return ranked JSON results.

63|8|Updated Feb 16, 2026
One-click install
npx skills add https://github.com/JoranHonig/grimoire --skill librarian-library-search
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: librarian-library-search
Source: https://github.com/JoranHonig/grimoire/tree/main/skills/librarian-library-search
Command: npx skills add https://github.com/JoranHonig/grimoire --skill librarian-library-search

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires qdrant-client[fastembed], fire, and includes scripts (resource) components.

What problem does it solve?

Provides natural-language, semantic search across locally indexed libraries so agents can find relevant research content even when exact keywords differ. It eliminates noisy grep results by ranking document chunks by meaning and returning source metadata for citation.

Core Features & Use Cases

  • Vector similarity search against a local Qdrant collection to surface semantically relevant document chunks.
  • Source-aware results that include similarity score, file path, chunk index, and source URL for trustworthy citations.
  • Scoped filtering and model alignment to restrict searches to a named library and ensure the same FastEmbed embedding model is used for consistent results.
  • Use Case: A security researcher asks for "reentrancy vulnerability in pull-payment pattern" and receives ranked excerpts from multiple indexed libraries with direct links to the originating files.

Quick Start

Search the local librarian libraries for "reentrancy vulnerability in pull-payment pattern" and return the top five results with scores and source metadata.

Frequently Asked Questions about librarian-library-search

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

FAQPage Schema
How do I perform semantic vector search over local library content for security research?

Semantic vector search over local library content uses a local Qdrant collection to rank indexed document chunks by meaning. This surfaces relevant excerpts for natural language queries, returning JSON-ranked results with similarity scores and source metadata.

Why does semantic search return better results than exact text grep for indexed libraries?

Semantic search returns better results than exact text grep because it ranks document chunks by meaning rather than exact keyword matches. This eliminates noisy grep results by finding relevant research content even when the exact phrasing differs.

Do I need a specific FastEmbed embedding model to query a local Qdrant knowledge base?

Yes, querying a local Qdrant knowledge base requires the same FastEmbed embedding model used during indexing. This model alignment ensures consistent vector similarity scores and accurate semantic retrieval of document chunks.

Can I restrict semantic search results to a specific named library?

Yes, you can restrict semantic search results to a specific named library using scoped filtering. This limits the vector similarity search to a subset of the local Qdrant collection, returning source-aware results only from the specified library.

What metadata is included with ranked document chunks from a vector similarity search?

Ranked document chunks from a vector similarity search include similarity scores, file paths, chunk indices, and source URLs. This source-aware metadata provides trustworthy citations for natural language queries against indexed libraries.