# Search Weaviate

> Perform hybrid, semantic, or keyword search on a collection.

- Skill: `tools-only/search-weaviate` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add tools-only/search-weaviate`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tools-only/search-weaviate/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: tools-only (https://skillmd.com/u/tools-only)
- Updated: 2026-09-29
- Page: https://skillmd.com/skills/tools-only/search-weaviate

---


# Search Weaviate

Perform hybrid, semantic, or keyword search on a collection.

## Usage

```
/weaviate:search query "your query" collection "CollectionName" [type "hybrid"] [alpha "0.5"] [limit "10"]
```

## Workflow

When necessary, use AskUserQuestion to make entering arguments easier.

1. Parse arguments
2. If collection is missing:
   - Run `/weaviate:collections` to list available collections
   - Use AskUserQuestion to prompt user to select
3. If type is not specified, default to `hybrid`
4. Run the appropriate script based on type:

### Hybrid (default)
```bash
uv run ${CLAUDE_PLUGIN_ROOT}/skills/weaviate/scripts/hybrid_search.py --query "USER_QUERY" --collection "COLLECTION_NAME" --alpha 0.7 --limit 10
```

### Semantic
```bash
uv run ${CLAUDE_PLUGIN_ROOT}/skills/weaviate/scripts/semantic_search.py --query "USER_QUERY" --collection "COLLECTION_NAME" --limit 10
```

### Keyword
```bash
uv run ${CLAUDE_PLUGIN_ROOT}/skills/weaviate/scripts/keyword_search.py --query "USER_QUERY" --collection "COLLECTION_NAME" --limit 10
```

## Examples

```
/weaviate:search query "machine learning" collection "Articles"
/weaviate:search query "SKU-12345" collection "Products" type "keyword"
/weaviate:search query "similar concepts" collection "Documents" type "semantic"
```

## Environment

Requires:
- `WEAVIATE_URL`: Weaviate Cloud cluster URL
- `WEAVIATE_API_KEY`: API key for authentication