New to Claude Skills? Learn how to install them →

civitai on GitHub

Meilisearch Admin

Free

Monitor and manage your Meilisearch indexes with ease.

by civitai7.2k stars on civitai/civitai
1 views
Updated Aug 10, 2026
Get this skill

Free · Opens the source repo

What Meilisearch Admin does

The Meilisearch Admin skill provides a command-line interface for performing administrative tasks on Meilisearch indexes. It allows users to check the health of the Meilisearch instance, monitor indexing tasks, and inspect index configurations. This skill is particularly useful for developers and data engineers who need to ensure their search functionality is running smoothly and efficiently. With this skill, you can perform read-only operations that are essential for maintaining the integrity and performance of your search indexes.

Using the skill is straightforward. You can run various commands to gather information about the status of your Meilisearch instance and its tasks. For example, commands like health, stats, and task-summary provide insights into the overall health and performance of the search service. Additionally, you can list all indexes or query specific index settings, making it easier to manage your search configurations without needing to dive into the Meilisearch API directly.

This skill is designed for those who require a reliable way to monitor their Meilisearch setup, whether for debugging purposes or routine checks. It is particularly beneficial in scenarios where indexing tasks may fail or become stuck, as it provides commands to identify and troubleshoot these issues quickly. By leveraging this skill, users can maintain a high level of operational oversight over their search indexes, ensuring that they are always optimized for performance.

In summary, the Meilisearch Admin skill is a valuable tool for developers and engineers working with Meilisearch, providing essential commands for monitoring and managing search indexes effectively.

When to use it

Use this skill when you need to check the status of your Meilisearch instance or troubleshoot indexing tasks.

When not to use it

This skill is not suitable for making changes to index configurations or performing write operations, as it only supports read-only tasks.

What you can build with it

Debugging Indexing Issues

Use the skill to check for failed or stuck indexing tasks, helping you quickly identify and resolve issues.

Monitoring Search Performance

Regularly check the health and stats of your Meilisearch instance to ensure optimal search performance.

Inspecting Index Configurations

Retrieve detailed information about index settings and attributes to verify configurations and optimize search results.

How to install Meilisearch Admin

View source

1. Install with the skills CLI

npx skills add civitai/civitai/meilisearch-admin --agent claude-code

2. Or install it manually

Download the skill folder and drop it into ~/.claude/skills/ for all projects, or .claude/skills/ to scope it to one repo. Restart Claude Code so it picks up the new skill.

Anthropic's agentic coding CLI, and the reference implementation of Agent Skills. Drop a skill folder into ~/.claude/skills and Claude Code loads it automatically whenever a task matches the skill's description. Claude Code docs

Inside SKILL.md

Written by civitai

Meilisearch Admin

Use this skill for admin operations on Meilisearch - checking status, monitoring tasks, and inspecting index settings.

Running Commands

node .claude/skills/meilisearch-admin/query.mjs <command> [options]

Commands

CommandDescription
healthCheck if Meilisearch is healthy
statsGet overall stats and list indexes
task-summaryTask count breakdown by status
tasksList recent tasks
task <id>Get details of a specific task
indexesList all indexes
index <name>Get index stats
index <name> settingsGet all index settings
index <name> filterableGet filterable attributes
index <name> sortableGet sortable attributes
index <name> searchableGet searchable attributes

Options

FlagDescription
--feedUse 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)
--jsonOutput raw JSON

Examples

# 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:

InstanceEnv VariablesPurpose
Main SearchSEARCH_HOST, SEARCH_API_KEYPrimary search (models, users, etc.)
Feed/MetricsMETRICS_SEARCH_HOST, METRICS_SEARCH_API_KEYImage 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

# 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>

Frequently asked questions about Meilisearch Admin

Similar skills