# Query Agent - Search Mode

> Retrieve raw objects using natural language queries across multiple collections via the Weaviate Query Agent.

- Skill: `tools-only/query-agent-search-mode` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add tools-only/query-agent-search-mode`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tools-only/query-agent-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-agent-search-mode

---

# Query Agent - Search Mode

Retrieve raw objects using natural language queries across multiple collections via the Weaviate Query Agent.

## Usage

```bash
uv run scripts/query_search.py --query "USER_QUERY" --collections "Collection1,Collection2" [--limit 10] [--json]
```

## Parameters

| Parameter | Flag | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| `--query` | `-q` | Yes | — | Natural language search query |
| `--collections` | `-c` | Yes | — | Comma-separated collection names to search across |
| `--limit` | `-l` | No | `10` | Maximum number of results to return |
| `--json` | — | No | `false` | Output in JSON format |

## Output

- **Default**: Markdown table with UUIDs, collection names, and all object properties (columns generated dynamically)
- **JSON**: Array of objects with `uuid`, `collection`, and `properties`

## Examples

Search across collections:

```bash
uv run scripts/query_search.py --query "machine learning papers" --collections "Articles,Research" --limit 5
```

JSON output:

```bash
uv run scripts/query_search.py --query "products under $50" --collections "Products" --json
```