---
title: "Weaviate: review, setup & limitations · Undominated.ai"
canonical: https://undominated.ai/skills/weaviate-weaviate/
description: "Weaviate skill that runs bundled Python scripts against a Weaviate Cloud cluster to list, inspect and create collections, search them, ask the Query Agent, and import files or example data."
---

# Weaviate: review, setup & limitations · Undominated.ai

> Weaviate skill that runs bundled Python scripts against a Weaviate Cloud cluster to list, inspect and create collections, search them, ask the Query Agent, and import files or example data.

[← Explore all skills](/skills/)

DATABASES / Weaviate

# Weaviate

Weaviate skill that runs bundled Python scripts against a Weaviate Cloud cluster to list, inspect and create collections, search them, ask the Query Agent, and import files or example data.

 [See setup guidance ↓](#setup)[Original source ↗](https://docs.weaviate.io/weaviate)

SOURCE REVIEW

 Reviewed 2026-10-21
 Evidence 8 linked sources
 Publisher Weaviate
 Licence [BSD-3-Clause ↗](https://github.com/weaviate/agent-skills/blob/b19751cb6aab9365fcd643974cfc1ae895fe92a8/LICENSE)
 Revision b19751cb6aab
 [Read what was—and wasn’t—checked ↓](#review)

“Search, query, and manage Weaviate vector database collections. Use for semantic search, hybrid search, keyword search, natural language queries with AI-generated answers, collection management, data exploration, filtered fetching, data imports from PDF/CSV/JSON/JSONL files, create example data and collection creation.”

 [Weaviate · upstream description ↗](https://github.com/weaviate/agent-skills/blob/b19751cb6aab9365fcd643974cfc1ae895fe92a8/skills/weaviate/SKILL.md) Our analysis follows below.

01 / THE REASONING

## Why this made the selection.

 - SKILL.md indexes a reference file per operation (Query Agent ask and search modes, hybrid search as the default, semantic and keyword search, listing, inspecting, exploring and creating collections, fetch and filter, file import, example data). Its recommendations name the bundled script to run with uv run for listing, inspecting, exploring and creating collections, importing, example data and each search mode; fetch and filter appears only as a link to its reference.
- It records Weaviate Cloud free-tier limits with their error codes (429 USAGE_LIMIT_EXCEEDED for a second collection, 422 CONFIG_NOT_ALLOWED for a PDF import that must create its collection or a non-hfresh index), tells the agent to ask before spending the single collection slot, and states that the scripts pin weaviate-client 4.23.1.

### A good fit for

 - List the collections on a Weaviate Cloud cluster and read a collection's schema before searching it
- Search a collection with hybrid, semantic or keyword search, or ask the Query Agent for an answer with source citations
- Import a CSV, JSON, JSONL or PDF file into a collection
- Create an example collection from a Hugging Face dataset when no data is available and the user asks for it

### Weigh up before choosing

 - skills/weaviate last changed in a commit dated 2026-10-16; the pinned revision is dated 2026-10-20.
- SKILL.md lists WEAVIATE_URL ("Your Weaviate Cloud cluster URL") and WEAVIATE_API_KEY as required. The shared connection module weaviate_conn.py exits when either is unset and connects only through weaviate.connect_to_weaviate_cloud.
- SKILL.md says a free-tier cluster allows one collection (a second create is refused with 429 USAGE_LIMIT_EXCEEDED), example_data.py uses that slot, a PDF import that has to create its collection is refused with 422 CONFIG_NOT_ALLOWED, and only the hfresh vector index is accepted; it also says these limits can change. No script deletes a collection.
- PDF import needs Poppler: import.py raises an error naming brew install poppler or sudo apt-get install poppler-utils when pdftoppm is missing.
- Every provider key variable that is set in the environment is sent to the Weaviate cluster as a request header, whether or not the collection uses it; the environment reference says to set only the keys the collection uses.
- The README's security note says the scripts and cookbooks rely on third-party packages, that Weaviate is not responsible for their security, and that users should run their own security scans before executing any code.
- LICENSE is a BSD three-clause text with no SPDX identifier, beginning "Copyright (c) 2020-2026, Weaviate B.V." and "All rights reserved."

02 / THE REVIEW RECORD

## What we actually inspected.

Source review has boundaries. A clear record is more useful than a “safe” badge.

### Material inspected

 - skills/weaviate/SKILL.md at b19751cb6aab9365fcd643974cfc1ae895fe92a8
- skills/weaviate/references/environment_requirements.md at b19751cb6aab9365fcd643974cfc1ae895fe92a8
- skills/weaviate/scripts/weaviate_conn.py at b19751cb6aab9365fcd643974cfc1ae895fe92a8
- skills/weaviate/scripts/import.py at b19751cb6aab9365fcd643974cfc1ae895fe92a8: dependencies, PDF reading, PDF collection schema, create-or-append logic
- skills/weaviate/scripts/example_data.py at b19751cb6aab9365fcd643974cfc1ae895fe92a8: dependencies, docstring and dataset loading
- The get_client import lines of all 12 scripts in skills/weaviate/scripts/ at b19751cb6aab9365fcd643974cfc1ae895fe92a8
- README.md, LICENSE, .claude-plugin/marketplace.json and .claude-plugin/plugin.json at b19751cb6aab9365fcd643974cfc1ae895fe92a8

### Our findings

 - import.py and example_data.py import get_client from weaviate_conn.py, which reads WEAVIATE_URL and WEAVIATE_API_KEY, maps 17 provider key variables to request headers, and connects with weaviate.connect_to_weaviate_cloud.
- import.py renders each PDF page to a base64 JPEG and, when the collection is absent, creates it with a multi2vec_weaviate vectorizer (ModernVBERT/colmodernvbert with MUVERA encoding); CSV, JSON and JSONL imports need an existing collection.
- example_data.py downloads its datasets from the Hugging Face hub with load_dataset, for example jamescalam/ai-arxiv2 for the default academic domain.
- The README prints no command that installs this skill alone. npx skills add weaviate/agent-skills adds the repository's 3 skills (engram_memory, weaviate-cookbooks, weaviate); the plugin install adds the weaviate plugin, sourced from the repository root, whose marketplace description says it includes database operations, cookbooks and CLI commands.

### Not established by this review

 - Not executed: it was not installed or run.
- No Weaviate cluster was contacted, no collection was created and no data was imported.
- No Hugging Face dataset was downloaded and no provider key was used.

The review applies to the material and revision named here. A newer upstream release can change its behavior.

03 / PUT IT TO WORK

## Add a skill to your workflow.

[Upstream setup instructions ↗](https://github.com/weaviate/agent-skills/blob/b19751cb6aab9365fcd643974cfc1ae895fe92a8/README.md)
 - The README prints `npx skills add weaviate/agent-skills` for Cursor, Claude Code, Gemini CLI and others. At this revision the repository holds 3 SKILL.md files (engram_memory, weaviate-cookbooks and weaviate), so that line adds all three, not this skill alone.
- For the Claude Code plugin manager the README prints `/plugin marketplace add weaviate/agent-skills` and `/plugin install weaviate@weaviate-plugins`. The marketplace lists one plugin, weaviate, sourced from the repository root; its description says it includes database operations, cookbooks and CLI commands.
- The README's manual route is `git clone https://github.com/weaviate/agent-skills.git`, `cd agent-skills` and `claude --plugin-dir .`, which points Claude Code at the whole repository directory.
- Before running a script, export WEAVIATE_URL and WEAVIATE_API_KEY as the README's configuration section shows, plus only the provider keys the collection uses.

### Before you start

 - Python 3.11+ and uv (recommended) or pip, as the README requires
- A Weaviate Cloud instance; the README recommends creating a free cluster in the Weaviate console
- Poppler, for PDF import only

### Compatibility

Claude Code · Cursor · GitHub Copilot · Gemini CLI · Weaviate Cloud

### Implementation

Python

### Weaviate Cloud URL and API key; scripts create collections and write objects

 - Reads WEAVIATE_URL and WEAVIATE_API_KEY, and any of 17 provider key variables that are set (for example OPENAI_API_KEY, COHERE_API_KEY, ANTHROPIC_API_KEY, AWS_ACCESS_KEY, AWS_SECRET_KEY); each one set is sent to the Weaviate cluster in its matching X- header, such as X-OpenAI-Api-Key.
- Runs the bundled Python scripts with uv run. import.py's inline metadata pins weaviate-client==4.23.1 and typer==0.21.0 and adds pdf2image>=1.17.0 and pillow>=10.0.0; example_data.py's adds weaviate-agents==1.2.0 and datasets>=4.5.0.
- Reads local CSV, JSON, JSONL and PDF files named on the command line; each PDF page is converted to a JPEG and uploaded as base64 into a BLOB property.
- Creates collections (create_collection.py, example_data.py, and import.py for a PDF when the collection is absent) and inserts objects into them. SKILL.md says no script deletes a collection.
- example_data.py downloads a dataset from the Hugging Face dataset hub before importing it.

### Cost model

BSD-3-Clause skill text. The README recommends a free Weaviate Cloud cluster and SKILL.md describes free-tier limits; the files read state no price for Weaviate Cloud or for the inference providers whose keys are forwarded.

04 / FOLLOW THE EVIDENCE

## The source trail.

Our notes are separate from the original resource. Check upstream before adopting a new version.

 - [weaviate SKILL.md at b19751cb ↗](https://github.com/weaviate/agent-skills/blob/b19751cb6aab9365fcd643974cfc1ae895fe92a8/skills/weaviate/SKILL.md) Checked 2026-10-21 https://github.com/weaviate/agent-skills/blob/b19751cb6aab9365fcd643974cfc1ae895fe92a8/skills/weaviate/SKILL.md Supports: upstreamDescription, whySelected, bestFor, limitations, access, review.findings
- [references/environment_requirements.md at b19751cb ↗](https://github.com/weaviate/agent-skills/blob/b19751cb6aab9365fcd643974cfc1ae895fe92a8/skills/weaviate/references/environment_requirements.md) Checked 2026-10-21 https://github.com/weaviate/agent-skills/blob/b19751cb6aab9365fcd643974cfc1ae895fe92a8/skills/weaviate/references/environment_requirements.md Supports: access, limitations
- [scripts/weaviate_conn.py at b19751cb ↗](https://github.com/weaviate/agent-skills/blob/b19751cb6aab9365fcd643974cfc1ae895fe92a8/skills/weaviate/scripts/weaviate_conn.py) Checked 2026-10-21 https://github.com/weaviate/agent-skills/blob/b19751cb6aab9365fcd643974cfc1ae895fe92a8/skills/weaviate/scripts/weaviate_conn.py Supports: access, limitations, review.findings
- [scripts/import.py at b19751cb ↗](https://github.com/weaviate/agent-skills/blob/b19751cb6aab9365fcd643974cfc1ae895fe92a8/skills/weaviate/scripts/import.py) Checked 2026-10-21 https://github.com/weaviate/agent-skills/blob/b19751cb6aab9365fcd643974cfc1ae895fe92a8/skills/weaviate/scripts/import.py Supports: access, limitations, review.findings, install
- [scripts/example_data.py at b19751cb ↗](https://github.com/weaviate/agent-skills/blob/b19751cb6aab9365fcd643974cfc1ae895fe92a8/skills/weaviate/scripts/example_data.py) Checked 2026-10-21 https://github.com/weaviate/agent-skills/blob/b19751cb6aab9365fcd643974cfc1ae895fe92a8/skills/weaviate/scripts/example_data.py Supports: access, bestFor, review.findings
- [README.md at b19751cb ↗](https://github.com/weaviate/agent-skills/blob/b19751cb6aab9365fcd643974cfc1ae895fe92a8/README.md) Checked 2026-10-21 https://github.com/weaviate/agent-skills/blob/b19751cb6aab9365fcd643974cfc1ae895fe92a8/README.md Supports: homepage, install, compatibility, limitations, access, review.findings
- [.claude-plugin/marketplace.json at b19751cb ↗](https://github.com/weaviate/agent-skills/blob/b19751cb6aab9365fcd643974cfc1ae895fe92a8/.claude-plugin/marketplace.json) Checked 2026-10-21 https://github.com/weaviate/agent-skills/blob/b19751cb6aab9365fcd643974cfc1ae895fe92a8/.claude-plugin/marketplace.json Supports: install, review.findings
- [BSD-3-Clause LICENSE at b19751cb ↗](https://github.com/weaviate/agent-skills/blob/b19751cb6aab9365fcd643974cfc1ae895fe92a8/LICENSE) Checked 2026-10-21 https://github.com/weaviate/agent-skills/blob/b19751cb6aab9365fcd643974cfc1ae895fe92a8/LICENSE Supports: license, limitations

KEEP COMPARING

## Other approaches to consider.

Related by category or shared topics. These are alternatives to inspect, not a measured quality order.

 [### MongoDB Search and AI ↗ Chooses between Atlas Search, Vector Search, Automated Embedding and hybrid search, and creates indexes only after explicit approval.](/skills/mongodb-mongodb-search-and-ai/)[### Pinecone quickstart ↗ Pinecone's onboarding skill: either a semantic-search demo on a new integrated index through the Pinecone MCP and a bundled upsert script, or a Pinecone Assistant built from the user's own documents.](/skills/pinecone-quickstart/)[### Qdrant clients SDK ↗ Qdrant skill that lists the official client SDKs with their repositories and installation lines, points to the REST and gRPC API references, and fetches code examples from a remote snippet search.](/skills/qdrant-clients-sdk/)

 [AI Tools ↗](/tools/)[Skills ↗](/skills/)[Agents ↗](/agents/)[MCP Servers ↗](/mcp-servers/)[Workflows ↗](/workflows/)

## Continue your investigation

 - [Choose a toolkit](/tools/)
- [Inspect execution hosts](/agents/)
- [Check tool access](/mcp-servers/)
- [Check project dependencies](/check-repo/)
