
Meilisearch Admin
FreeMonitor and manage your Meilisearch indexes with ease.
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 source1. Install with the skills CLI
npx skills add civitai/civitai/meilisearch-admin --agent claude-code2. 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 civitaiMeilisearch 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
| 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
# 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 searchusers_v3- User searcharticles_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
ClickHouse Logs Queries
Efficiently manage Supabase logs with ClickHouse SQL.
EF Core D2 Database Diagram Generator
Visualize your EF Core models as D2 diagrams effortlessly.
Safe SQL Execution
Ensure secure SQL execution in Supabase applications.
Oracle to PostgreSQL Migration
Identify migration risks between Oracle and PostgreSQL.
SSMA Console
Streamline Oracle to SQL Server migrations with ease.
SQL Performance Optimization
Enhance SQL query efficiency across all databases.
