knowledge-query

Retrieve factual information from a pgvector Knowledge base using hybrid search.

520|175|Updated Apr 8, 2026
One-click install
npx skills add https://github.com/evolution-foundation/evo-nexus --skill knowledge-query-evolution-foundation
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: knowledge-query
Source: https://github.com/evolution-foundation/evo-nexus/tree/main/.claude/skills/knowledge-query
Command: npx skills add https://github.com/evolution-foundation/evo-nexus --skill knowledge-query-evolution-foundation

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you find grounded answers by searching the indexed Knowledge base and optionally synthesizing a narrative response with citations.

Core Features & Use Cases

  • Hybrid retrieval from pgvector: Combines vector similarity with BM25 using Reciprocal Rank Fusion (RRF) plus metadata boosting.
  • Targeted filtering: Supports narrowing by connection, space, and filters such as unit, content type, topics, and date range.
  • Optional RAG synthesis: When answer=true, it produces a composed answer grounded in the retrieved snippets and appends sources.

Quick Start

Ask your agent: "@knowledge What do we know about <topic> and include citations".

Frequently Asked Questions about knowledge-query

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

FAQPage Schema
How does hybrid retrieval combine vector search and BM25 for knowledge base lookup?▼

Hybrid retrieval merges vector similarity with BM25 keyword matching using Reciprocal Rank Fusion (RRF) to locate factual information in a pgvector knowledge base. This combination ensures both semantic context and exact keyword relevance improve search accuracy.

How do I search my knowledge base and get citations in the response?▼

You can search your knowledge base by querying with a command like "@knowledge <query>". Setting the answer parameter to true synthesizes a narrative response grounded in retrieved snippets and appends citations for source verification.

Can I filter knowledge search results by metadata like topics or date range?▼

Yes, knowledge search supports targeted filtering. You can narrow retrieval results by specifying connection, space, unit, content type, topics, and date range to apply metadata-boosted filtering against the indexed knowledge base.

What is the best way to retrieve top-k chunks from pgvector for question answering?▼

Using RAG with hybrid retrieval is the best way to fetch top-k chunks. It queries the pgvector knowledge base using RRF to combine vector and BM25 results, returning relevant chunks for question answering or targeted retrieval.

Does knowledge search work if a specified connection or space is unavailable?▼

The search mechanism handles connection and space availability errors. If a specified connection or space is missing or unavailable, the system manages the error rather than failing silently during the knowledge base retrieval process.