Agent Skills › ory/lumen › doctor

doctor

GitHub

对 Lumen 语义搜索进行健康检查，验证嵌入服务可达性和索引新鲜度，并汇总修复步骤。

skills/doctor/SKILL.md ory/lumen

Trigger Scenarios

需要诊断 Lumen 语义搜索配置状态检查索引是否过期或存储异常

Install

npx skills add ory/lumen --skill doctor -g -y

More Options

Use without installing

npx skills use ory/lumen@doctor

指定 Agent (Claude Code)

npx skills add ory/lumen --skill doctor -a claude-code -g -y

安装 repo 全部 skill

npx skills add ory/lumen --all -g -y

预览 repo 内 skill

npx skills add ory/lumen --list

SKILL.md

Frontmatter

{
    "name": "doctor",
    "description": "Run a health check on the bundled Lumen semantic search setup for the current project, verify backend reachability and index freshness, and summarize remediation steps."
}

Lumen Doctor

Run a health check on the bundled Lumen semantic search setup for the current project.

Steps

Call the Lumen health_check tool to verify the embedding service is reachable.
Call the Lumen index_status tool with path or cwd set to the current working directory to check index freshness.
Report a concise summary:
- Embedding service status, backend, host, and model
- Index totals: files, chunks, last indexed time, stale or fresh
- Storage totals: unique vectors, shared references, deduplication ratio, vector precision, database bytes, and reclaimable bytes
- Any MCP or plugin setup issue that blocks the tools
If no index exists yet, explain that the Lumen semantic_search tool seeds the index on first use.
If the user wants eager indexing instead of waiting for the next search, suggest running lumen index . in the repository root.
Interpret storage totals as collection-wide values shared by compatible Git worktrees; file, chunk, freshness, and indexing values are project-local. A high deduplication ratio is expected and is not an index-health problem.