meilisearch-admin — Claude Code skill: search debugging
meilisearch-admin — a skill for monitoring Meilisearch: check indexes, tasks, server health, and search settings. Spot indexing errors and diagnose what's wrong with your search.
Apache-2.0 132 installs ★ 7,327 updated 2026-10-25
npx skills add civitai/civitai --skill meilisearch-admin -a claude-codeWhat meilisearch-admin does
meilisearch-admin exposes read-only admin operations through a command interface. Query index status, browse indexing tasks and their history, inspect filterable and sortable field configuration. The skill connects to two search instances: the main one (SEARCH_HOST) and a metrics feed (METRICS_SEARCH_HOST). Commands cover health checks, overall stats, individual task details, and per-index state. Requires Node.js and access to query.mjs in the skill directory.
When indexing stalls or a task fails, you get the reason: task status, error details, and what's being indexed right now.
What it helps with
- Check if Meilisearch is running and an index is healthy
- Find stuck or failed indexing tasks
- View which index fields are filterable or sortable
- Track the queue and status of recent search operations
- Compare configuration across indexes
Example prompts for the agent
- Check index status:
node .claude/skills/meilisearch-admin/query.mjs index models_v9 - See failed tasks:
node .claude/skills/meilisearch-admin/query.mjs tasks --status failed - Monitor what's indexing:
node .claude/skills/meilisearch-admin/query.mjs tasks --status processing --limit 50
How to install meilisearch-admin
1Skills CLI (Vercel)
npx skills add civitai/civitai --skill meilisearch-admin -a claude-code2Manually: put the files in place
~/.claude/skills/meilisearch-admin/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/meilisearch-admin/
1Skills CLI (Vercel)
npx skills add civitai/civitai --skill meilisearch-admin -a codex2Manually: put the files in place
.agents/skills/meilisearch-admin/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add civitai/civitai --skill meilisearch-admin -a cursor2Manually: put the files in place
.cursor/skills/meilisearch-admin/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install civitai/civitai .claude/skills/meilisearch-admin2Manually: put the files in place
.github/skills/meilisearch-admin/SKILL.md1Skills CLI (Vercel)
npx skills add civitai/civitai --skill meilisearch-admin -a gemini-cli2Platform CLI
gemini skills install https://github.com/civitai/civitai --path .claude/skills/meilisearch-adminManually: put the files in place
.devin/skills/meilisearch-admin/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add civitai/civitai --skill meilisearch-admin -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about meilisearch-admin
How do I install meilisearch-admin in Claude Code?
Run npx skills add civitai/civitai --skill meilisearch-admin -a claude-code, then check the instructions in ~/.claude/skills/meilisearch-admin/SKILL.md.
What does meilisearch-admin do?
It provides commands to monitor Meilisearch: check indexes, track indexing tasks, view field configuration, and diagnose search errors.
How do I find out why an indexing task failed?
First list failed tasks with node .claude/skills/meilisearch-admin/query.mjs tasks --status failed. Then get details for the task ID: node .claude/skills/meilisearch-admin/query.mjs task <id>.
Source text
SKILL.md · Apache-2.0
--- name: meilisearch-admin description: Check Meilisearch index status, tasks, health, and settings. Use for debugging search issues, monitoring indexing tasks, and inspecting index configuration. Read-only admin operations. --- # Meilisearch Admin Use this skill for admin operations on Meilisearch - checking status, monitoring tasks, and inspecting index settings. ## Running Commands ```bash node .claude/skills/meilisearch-admin/query.mjs <command> [options] ``` ### Commands | Command | Description | |---------|-------------| | `health` | Check if Meilisearch is healthy | | `stats` | Get overall stats and list indexes | | `task-summary` | Task count breakdown by status | | `tasks` | List recent tasks | | `task <id>` | Get details of a specific task | | `indexes` | List all indexes | | `index <name>` | Get index stats | | `index <name> settings` | Get all index settings | | `index <name> filterable` | Get filterable attributes | | `index <name> sortable` | Get sortable attributes | | `index <name> searchable` | Get searchable attributes | ### Options | Flag | Description | |------|-------------| | `--feed` | Use feed/metrics search (METRICS_SEARCH_HOST) instead of main search | | `--status <s>` | Filter tasks by status: enqueued, processing, succeeded, failed | | `--limit <n>` | Limit results (default: 20) | | `--json` | Output raw JSON | ### Examples ```bash # Check health node .claude/skills/meilisearch-admin/query.mjs health # Get overall stats node .claude/skills/meilisearch-admin/query.mjs stats # Task count summary by status node .claude/skills/meilisearch-admin/query.mjs task-summary # Check failed tasks node .claude/skills/meilisearch-admin/query.mjs tasks --status failed # Check processing tasks node .claude/skills/meilisearch-admin/query.mjs tasks --status processing --limit 50 # Get specific task details node .claude/skills/meilisearch-admin/query.mjs task 2030419 # List all indexes node .claude/skills/meilisearch-admin/query.mjs indexes # Get index stats node .claude/skills/meilisearch-admin/query.mjs index models_v9 # Get filterable attributes for an index node .claude/skills/meilisearch-admin/query.mjs index metrics_images_v1 filterable # Use feed search instead of main node .claude/skills/meilisearch-admin/query.mjs --feed stats node .claude/skills/meilisearch-admin/query.mjs --feed tasks --status failed ``` ## Search Instances The project has two Meilisearch instances: | Instance | Env Variables | Purpose | |----------|---------------|---------| | **Main Search** | `SEARCH_HOST`, `SEARCH_API_KEY` | Primary search (models, users, etc.) | | **Feed/Metrics** | `METRICS_SEARCH_HOST`, `METRICS_SEARCH_API_KEY` | Image feed and metrics search | Use `--feed` flag to target the feed/metrics instance. ## Common Indexes ### Main Search - `models_v9` - Model search - `users_v3` - User search - `articles_v3` - Article search ### Feed/Metrics Search - `metrics_images_v1` - Image feed with metrics ## Debugging Tips ```bash # Check if indexing is stuck node .claude/skills/meilisearch-admin/query.mjs tasks --status processing # Find failed indexing tasks node .claude/skills/meilisearch-admin/query.mjs tasks --status failed # Get error details for a failed task node .claude/skills/meilisearch-admin/query.mjs task <taskId> # Check if an index is still indexing node .claude/skills/meilisearch-admin/query.mjs index <indexName> ```
© civitai · Apache-2.0 · civitai/civitai