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.
“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.”
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.
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.
- 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
04 / FOLLOW THE EVIDENCE
The source trail.
Our notes are separate from the original resource.
Check upstream before adopting a new version.
https://github.com/weaviate/agent-skills/blob/b19751cb6aab9365fcd643974cfc1ae895fe92a8/skills/weaviate/SKILL.md
Supports: upstreamDescription, whySelected, bestFor, limitations, access, review.findings
https://github.com/weaviate/agent-skills/blob/b19751cb6aab9365fcd643974cfc1ae895fe92a8/skills/weaviate/references/environment_requirements.md
Supports: access, limitations
https://github.com/weaviate/agent-skills/blob/b19751cb6aab9365fcd643974cfc1ae895fe92a8/skills/weaviate/scripts/weaviate_conn.py
Supports: access, limitations, review.findings
https://github.com/weaviate/agent-skills/blob/b19751cb6aab9365fcd643974cfc1ae895fe92a8/skills/weaviate/scripts/import.py
Supports: access, limitations, review.findings, install
https://github.com/weaviate/agent-skills/blob/b19751cb6aab9365fcd643974cfc1ae895fe92a8/skills/weaviate/scripts/example_data.py
Supports: access, bestFor, review.findings
- README.md at b19751cb ↗Checked
https://github.com/weaviate/agent-skills/blob/b19751cb6aab9365fcd643974cfc1ae895fe92a8/README.md
Supports: homepage, install, compatibility, limitations, access, review.findings
https://github.com/weaviate/agent-skills/blob/b19751cb6aab9365fcd643974cfc1ae895fe92a8/.claude-plugin/marketplace.json
Supports: install, review.findings
https://github.com/weaviate/agent-skills/blob/b19751cb6aab9365fcd643974cfc1ae895fe92a8/LICENSE
Supports: license, limitations