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.