weaviate
weaviate/agent-skills · skills.sh
Open source Repository Open in the app JSON README (API)
About
Skill publicada por weaviate/agent-skills no skills.sh. Instale com: npx skills add weaviate/agent-skills@weaviate
Details
- Kind
- Agent skills
- Topic
- Databases
- Publisher
- weaviate
- Origin
- skillssh
- Category
- ferramentas
- Stars
- 105
- Forks
- 18
- Open pull requests
- 1
- Last push
- 2026-09-30T14:45:03Z
- Repository state
- ativo
- Language
- Python
- License
- BSD-3-Clause
- Added
- 2026-10-06 04:49:19
- Updated
- 2026-10-06 04:49:19
- Origin id
weaviate/agent-skills/weaviate
README
# Weaviate Agent Skills
Agent Skills to help developers build and use AI agents with Weaviate more effectively. Each skill is a folder containing instructions, scripts, and resources that agents like Claude Code, Cursor, GitHub Copilot, and others can discover to work more accurately and efficiently
Works with any agent that supports the [Agent Skills](https://agentskills.io/home#adoption) format.
## Installation
### Using npx skills (Cursor, Claude Code, Gemini CLI, etc.)
```bash
npx skills add weaviate/agent-skills
```
### Using Claude Code Plugin Manager
```bash
/plugin marketplace add weaviate/agent-skills
/plugin install weaviate@weaviate-plugins
```
### Manual: clone and point your agent to the directory
```bash
git clone https://github.com/weaviate/agent-skills.git
cd agent-skills
claude --plugin-dir .
```
## Quickstart
New to Weaviate? Run the interactive onboarding to set up your environment variables, import your own or sample data, and explore the full functionality of the available skills/commands:
```bash
/weaviate:quickstart
```
## Configuration
### Weaviate Cloud
It is recommended to create a free cluster in the [weaviate console](https://console.weaviate.cloud/signin?utm_source=github&utm_campaign=agent_skills).
### Required Environment Variables
```bash
export WEAVIATE_URL="https://your-cluster.weaviate.cloud"
export WEAVIATE_API_KEY="your-api-key"
```
### External Provider Keys (Auto-Detected)
For the complete env var list and header mapping, see:
- [Environment Requirements](https://github.com/weaviate/agent-skills/blob/HEAD/skills/weaviate/references/environment_requirements.md)
## Available Skills
<details>
<summary><strong>Weaviate</strong></summary>
Utility functions for the agent to directly interact with a Weaviate database.
- Create Collections
- Explore Collections (Aggregation, Metadata, Schema)
- Query Collections (Keyword-, Vector-, Hybrid Search) (Support filters)
- Import Data (supports multi-vector and PDF ingestion)
- Query Agent
</details>
<details>
<summary><strong>Cookbooks</strong></summary>
Blueprints for complete end-to-end AI applications with state-of-the art guidelines for agentic infrastructure.
- Multimodal PDF Ingestion
- Data Explorer
- Retrieval Augmented Generation (Basic, Advanced, Agentic)
- Agents
- Query Agent Chatbot
- Frontend Interface (optional)
</details>
## Security Note
The scripts and cookbooks in this agent skills repository rely on some widely adopted third-party packages. However, we are not responsible for the security of any third-party components, as new vulnerabilities may arise at any time. The user should run their own security scans before executing any code and review packages flagged for known issues.
## Usage
### Commands (Claude Code Plugin)
```bash
# Interactive onboarding
/weaviate:quickstart
# Ask a question and get an AI-generated answer with source citations
/weaviate:ask query "What are the benefits of vector databases?" collections "Documentation"
# Search collections and get raw results
/weaviate:query query "machine learning tutorials" collections "Articles,BlogPosts" limit 5
# Search with different search types
/weaviate:search query "product SKU-123" collection "Products" type "keyword"
/weaviate:search query "similar items" collection "Products" type "semantic"
/weaviate:search query "best laptops" collection "Products" type "hybrid" alpha "0.7"
# List collections or get a collection's schema
/weaviate:collections
/weaviate:collections name "Articles"
# Explore data in a collection
/weaviate:explore "Products" limit 10
# Fetch objects by ID or with filters
/weaviate:fetch collection "Articles" id "UUID"
/weaviate:fetch collection "Articles" filters '{"property": "category", "operator": "equal", "value": "Science"}'
```
### Skills (Any Compatible Agent)
The skill is automatically discovered by compatible agents. Simply describe what you want:
- "Search my Weaviate documentation for information about HNSW indexing"
- "List all my Weaviate collections"
- "Find products similar to 'wireless headphones' in the Products collection"
- "Build a chatbot using the Query Agent"
- "Build a multimodal RAG app for my PDF documents"
- "Build an agentic RAG app"
## Requirements
- Python 3.11+
- [uv](https://docs.astral.sh/uv/) (recommended) or pip
- A [Weaviate Cloud](https://console.weaviate.cloud/signin?utm_source=github&utm_campaign=agent_skills) instance
## Resources
- eBooks
- [The Context Engineering Guide](https://weaviate.io/ebooks/the-context-engineering-guide?utm_source=github&utm_campaign=agent_skills)
- [Agentic Architecture Ebook](https://weaviate.io/ebooks/agentic-architectures?utm_source=github&utm_campaign=agent_skills)
- [Advanced RAG Techniques](https://weaviate.io/ebooks/advanced-rag-techniques?utm_source=github&utm_campaign=agent_skills)
- [Weaviate Query Agent](https://docs.weaviate.io/agents/query)
- [Weaviate Documentation](https://docs.weaviate.io/weaviate)
- [Agent Skills Specification](https://agentskills.io/specification)
- [Claude Code Plugins](https://code.claude.com/docs/en/plugins)