Search, query, inspect, create, and import data into Weaviate vector database collections using official scripts and references.
SkillScore74Maintained
Automatic
◆AI Engineer pack
Last verified 8/12/2026
What it changes
Passed 16 of 21 test cases with the skill, and 4 of 21 without it.
Without skill17%
With skill74%
Checks it passed that the model alone missed
Specifies adding the --json flag to the script command.
Recommends hybrid_search.py as the default search choice.
Recommends running example_data.py to generate sample data.
and 12 more in the full report
13 fixed4 passed either way6 still failing0 broke
Pass-rate lift
+57 pp
Tokens
+25%
Agent turns
0%
Response time
-55%
Model gemini-3.6-flashMeasured 8/12/2026v117 of 23 cases passed with skill · 21 comparable
Tokens, turns and time describe resource use, not a dollar price.
See it in action
One of 13 test cases the skill fixed. Same model, same prompt, with and without the skill.
1 of 13
Prompt
I am setting up a fresh local test environment and want to quickly populate the database with toy sample data to test search queries. Which script generates example data?
What was checked, without and with the skill
Checked
Without skill
With skill
Recommends running example_data.py to generate sample data.
Missed
Passed
case-13 · gemini-3.6-flash · 8/12/2026 · answers are capped and redacted
What's inside
The instructions your model reads when the skill loads.
SKILL.md116 lines27 filesincludes scripts
Weaviate Database Operations
This skill provides comprehensive access to Weaviate vector databases including search operations, natural language queries, schema inspection, data exploration, filtered fetching, collection creation, and data imports.
When to Use This Skill
Use when the user needs to inspect Weaviate collections, schemas, or data distribution.
Use when running semantic, hybrid, keyword, filtered, or Query Agent searches against Weaviate.
Use when importing CSV, JSON, JSONL, or PDF data into a Weaviate collection.
Use when creating example data or a collection for a Weaviate-backed workflow.
Weaviate Cloud Instance
If the user does not have an instance yet, direct them to the cloud console to register and create a free sandbox. Create a Weaviate instance via Weaviate Cloud.
Environment Variables
Required:
WEAVIATE_URL - Your Weaviate Cloud cluster URL
WEAVIATE_API_KEY - Your Weaviate API key
External Provider Keys (auto-detected):
Set only the keys your collections use, refer to Environment Requirements for more information.
Script Index
Search & Query
Query Agent - Ask Mode: Use when the user wants a direct answer to a question based on collection data. The Query Agent synthesizes information from one or more collections and returns a structured response with source citations (collection name and object ID).
Query Agent - Search Mode: Use when the user wants to explore or browse raw objects across one or more collections. Unlike ask mode, this returns the actual data objects rather than a synthesized answer.
Hybrid Search: Default choice for most searches. Provides a good balance of semantic understanding and exact keyword matching. Use this when you are unsure which search type to pick.
Semantic Search: Use for finding conceptually similar content regardless of exact wording. Best when the intent matters more than specific keywords.
Keyword Search: Use for finding exact terms, IDs, SKUs, or specific text patterns. Best when precise keyword matching is needed rather than semantic similarity.
Collection Management
List Collections: Use to discover what collections exist in the Weaviate instance. This should typically be the first step before performing any search or data operation.
Get Collection Details: Use to understand a collection's schema — its properties, data types, vectorizer configuration, replication factor, and multi-tenancy status. Helpful before running searches or imports.
Explore Collection: Use to analyze data distribution, top values, and inspect actual content in a collection. Helpful for understanding what data looks like before querying.