# Query Weaviate (Search Mode)

> Use Query Agent to search Weaviate collections with natural language. Returns objects for further processing.

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

---


# Query Weaviate (Search Mode)

Use Query Agent to search Weaviate collections with natural language. Returns objects for further processing.

## Usage

```
/weaviate:query query "your search query" collections "Collection1,Collection2" limit 10
```

## Workflow

When necessary, use AskUserQuestion to make entering arguments easier.

1. Parse the query, collections, and limit arguments
2. If arguments are missing:
   - Run `/weaviate:collections` to list available collections
   - Use AskUserQuestion to prompt user to select
   - Default limit to 10 if not specified
3. Run the Query Agent search script:
   ```bash
   uv run ${CLAUDE_PLUGIN_ROOT}/skills/weaviate/scripts/query_search.py --query "USER_QUERY" --collections "COLLECTION_1,COLLECTION_2" --limit "LIMIT"
   ```
4. Display results to user

## Example

```
/weaviate:query query "articles about vector databases" collections "Articles,BlogPosts" limit 5
```

## For Generated Answers

Use `/weaviate:ask` instead to get generated answers with sources.

## Environment

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