Agent Skills › civitai/civitai › meilisearch-admin

meilisearch-admin

GitHub

提供Meilisearch搜索引擎的只读管理功能，包括健康检查、索引状态查看、任务监控及配置审查。用于排查搜索问题、监控索引进度和分析索引结构。

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

Trigger Scenarios

检查搜索引擎健康状态监控索引任务进度或失败情况查询索引配置和统计信息排查搜索相关问题

Install

npx skills add civitai/civitai --skill meilisearch-admin -g -y

More Options

Non-standard path

npx skills add https://github.com/civitai/civitai/tree/main/.claude/skills/meilisearch-admin -g -y

Use without installing

npx skills use civitai/civitai@meilisearch-admin

指定 Agent (Claude Code)

npx skills add civitai/civitai --skill meilisearch-admin -a claude-code -g -y

安装 repo 全部 skill

npx skills add civitai/civitai --all -g -y

预览 repo 内 skill

npx skills add civitai/civitai --list

SKILL.md

Frontmatter

{
    "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

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