# Search Items

> Search items across a Directus collection using full-text search Arguments: <collection> <query>.

- Skill: `agents-store/search-items` (Agent Skill)
- Install (CLI): `npx get-skill add agents-store/search-items`
- Raw SKILL.md: https://api.skillmd.com/api/skills/agents-store/search-items/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: agents-store (https://skillmd.com/u/agents-store)
- Updated: 2026-11-16
- Page: https://skillmd.com/skills/agents-store/search-items

---


# Search Items

Follow the `item-operations` skill (`${CLAUDE_PLUGIN_ROOT}/skills/item-operations/SKILL.md`) for the query syntax, filters and batch rules; read it before the first call.

## Arguments

- `collection` (required) — Collection name
- `query` (required) — Search text

## Process

1. Parse collection name and search query
2. Call `schema` tool with `keys: ["<collection>"]` to determine best display fields
3. Call `items` tool with:
   ```json
   {
     "action": "read",
     "collection": "<collection>",
     "query": {
       "search": "<query>",
       "fields": ["id", "<main_field>", "<secondary_fields>"],
       "limit": 20
     }
   }
   ```
4. Display matching items as a table
5. Show count of results found

## Example

Input: `articles machine learning`

```json
{
  "action": "read",
  "collection": "articles",
  "query": {
    "search": "machine learning",
    "fields": ["id", "title", "status", "date_created"],
    "limit": 20
  }
}
```
