weaviate-query-agent

Query local Weaviate collections with semantic, hybrid, and RAG searches.

39|5|Updated Nov 4, 2025
One-click install
npx skills add https://github.com/saskinosie/weaviate-claude-skills --skill weaviate-query-agent
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: weaviate-query-agent
Source: https://github.com/saskinosie/weaviate-claude-skills/tree/main/weaviate-query-agent
Command: npx skills add https://github.com/saskinosie/weaviate-claude-skills --skill weaviate-query-agent

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires weaviate-client, openai.

What problem does it solve?

Extracting precise information from large datasets using vector search, keyword search, and Retrieval Augmented Generation (RAG) can be challenging. This Skill provides a comprehensive agent to intelligently query your local Weaviate database, filter results, and generate accurate answers, including analysis of visual content.

Core Features & Use Cases

  • Semantic & Hybrid Search: Find information based on meaning, keywords, or a powerful combination of both for highly relevant results.
  • Advanced Filtering: Refine search results using property-based conditions (e.g., filter by author, date, or category).
  • RAG (Retrieval Augmented Generation): Generate concise, context-aware answers to complex questions using retrieved information, including vision-enabled RAG for analyzing images and diagrams.
  • Use Case: Ask "What are the seismic zone requirements for building codes?" and get a direct answer with cited sources from your technical documentation collection, even analyzing relevant diagrams or maps within the documents.

Quick Start

Search my 'TechnicalDocuments' collection for information about "HVAC system maintenance" and summarize the key steps.

Frequently Asked Questions about weaviate-query-agent

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

FAQPage Schema
How do I query a Weaviate database using semantic search?

Semantic search in Weaviate uses vector embeddings to find results based on meaning rather than exact keywords. This Skill queries your local Weaviate collections with near_text, near_vector, or near_image operations, returning contextually relevant data without requiring exact term matches.

Can I combine keyword search and vector search in Weaviate queries?

Yes, hybrid search combines BM25 keyword matching with vector similarity in a single query. This Skill supports hybrid queries that weight both semantic and keyword relevance, delivering more precise results than either approach alone.

What's the best way to filter semantic search results in Weaviate?

Property-based filters narrow results by specific conditions like author, date, or category before or alongside semantic ranking. This Skill applies where conditions to refine your search space, ensuring retrieved data meets both semantic relevance and business logic requirements.

How do I use Retrieval Augmented Generation with Weaviate data?

RAG retrieves relevant documents from Weaviate, then passes them to a language model to generate context-aware answers with cited sources. This Skill orchestrates the retrieval and generation pipeline, supporting vision-enabled RAG to analyze images and diagrams within your documents.

What do I need to set up before querying Weaviate with this Skill?

You need a running Docker-based Weaviate instance, an active connection to it, ingested data in your collections, and Python weaviate-client installed. This Skill requires these prerequisites to execute near_text, near_vector, BM25, and hybrid queries against your local deployment.

Can I search images and diagrams in my Weaviate collections?

Yes, near_image queries search collections containing visual content by image or vision understanding. This Skill supports image-based retrieval and vision-enabled RAG, enabling analysis of diagrams, maps, and other visual documentation alongside text.