meilisearch-admin — скилл для Claude Code: отладка поиска
Скилл meilisearch-admin для мониторинга Meilisearch: проверяет индексы, задачи, здоровье сервера и настройки поиска. Помогает отловить ошибки в индексировании и понять, что происходит с поиском.
Apache-2.0 132 установок ★ 7 327 обновлён 2026-10-25
npx skills add civitai/civitai --skill meilisearch-admin -a claude-codeЧто делает meilisearch-admin
meilisearch-admin даёт доступ к read-only операциям администратора Meilisearch через единый интерфейс команд. Узнаёшь статус индексов, смотришь очередь и историю задач индексирования, проверяешь конфигурацию фильтруемых и сортируемых полей.
Скилл работает с двумя инстансами поиска: главный (SEARCH_HOST) и для ленты метрик (METRICS_SEARCH_HOST). Команды охватывают проверку здоровья сервера, общую статистику, детали конкретных задач и состояние отдельных индексов. Нужен Node.js и доступ к query.mjs в директории скилла.
Если индексирование зависает или задача упала, скилл помогает найти причину: увидишь статус каждой задачи, ошибки в деталях и что именно индексируется в данный момент.
Какие задачи решает
- Проверить, работает ли Meilisearch и здоров ли индекс
- Найти зависшие или упавшие задачи индексирования
- Узнать, какие атрибуты индекса отмечены как фильтруемые или сортируемые
- Отследить очередь и статус недавних операций поиска
- Сравнить конфигурацию разных индексов
Примеры запросов агенту
- Проверь статус индекса models_v9:
node .claude/skills/meilisearch-admin/query.mjs index models_v9 - Найди упавшие задачи:
node .claude/skills/meilisearch-admin/query.mjs tasks --status failed - Смотри, что индексируется:
node .claude/skills/meilisearch-admin/query.mjs tasks --status processing --limit 50
Как установить meilisearch-admin
1Через Skills CLI (Vercel)
npx skills add civitai/civitai --skill meilisearch-admin -a claude-code2Вручную: положить файлы
~/.claude/skills/meilisearch-admin/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/meilisearch-admin/
1Через Skills CLI (Vercel)
npx skills add civitai/civitai --skill meilisearch-admin -a codex2Вручную: положить файлы
.agents/skills/meilisearch-admin/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add civitai/civitai --skill meilisearch-admin -a cursor2Вручную: положить файлы
.cursor/skills/meilisearch-admin/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install civitai/civitai .claude/skills/meilisearch-admin2Вручную: положить файлы
.github/skills/meilisearch-admin/SKILL.md1Через Skills CLI (Vercel)
npx skills add civitai/civitai --skill meilisearch-admin -a gemini-cli2Командой платформы
gemini skills install https://github.com/civitai/civitai --path .claude/skills/meilisearch-adminВручную: положить файлы
.devin/skills/meilisearch-admin/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add civitai/civitai --skill meilisearch-admin -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о meilisearch-admin
Как установить meilisearch-admin в Claude Code?
Запусти npx skills add civitai/civitai --skill meilisearch-admin -a claude-code, потом посмотри инструкцию в ~/.claude/skills/meilisearch-admin/SKILL.md.
Что делает meilisearch-admin?
Даёт команды для мониторинга Meilisearch: проверяет индексы, отслеживает задачи индексирования, смотрит конфигурацию поля и ищет ошибки в поиске.
Как найти причину, почему индексирование упало?
Сначала посмотри задачи со статусом failed: node .claude/skills/meilisearch-admin/query.mjs tasks --status failed. Потом возьми ID задачи и узнай детали: node .claude/skills/meilisearch-admin/query.mjs task <id>.
Исходный текст
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