Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add civitai/civitai --skill meilisearch-admin -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/meilisearch-admin/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/meilisearch-admin/

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

Similar skills

All skills for Backend and APIs →

From the same set11

The whole set →
clickup clickup is a Claude Code skill for ClickUp tasks and docs: it reads details and comments, then creates or edits records from task or document URLs and IDs. CX Codex +1 1,800installs clickup Connects ClickUp's API to the agent. Reads task details by URL or ID, creates tasks, reassigns them, changes status, and posts comments. CX Codex +1 1,800installs quick-mockups quick-mockups generates 3 to 5 parallel UI mockups in HTML. Useful when you need to explore layouts, wireframes, and hierarchy variations before writing frontend code. CX Codex +1 1,700installs postgres-query postgres-query — a skill for Claude Code that executes PostgreSQL queries during debugging and performance analysis. It targets specific database environments with --prod or --dev flags under read-only mode. CX Codex +1 105installs agent-review Route code and prompts to external AI agents for review. Anthropic models use your local subscription via Claude Agent SDK; other models go through OpenRouter API. Useful for security audits, architecture validation, or a second opinion. CX Codex +1 3installs discord Posts messages, embeds, and announcements to Discord channels via REST API. Useful for team alerts and release notices during coding sessions. CX Codex +1 ★ 7,327repo stars clickhouse-query clickhouse-query runs ad-hoc ClickHouse queries from the chat: metrics, event data, execution plans. Read-only unless you say otherwise. CX Codex +1 ★ 7,327repo stars redis-inspect redis-inspect — a skill that reads keys, values and TTLs across two Redis instances, the main cache and the system cache. Handy when you need to see what the cache holds right now. CX Codex +1 ★ 7,327repo stars

Project sponsors

Companies that keep this analytics open