# doctor

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.

Skill by Ory. Category: Testing.

## Install

Project (for this project only):

```sh
npx skills add ory/lumen --skill doctor
```

Works with: Claude Code, Codex CLI, Cursor, Antigravity, Copilot CLI, opencode.

Global (for every project on this machine):

```sh
npx skills add ory/lumen --skill doctor -g
```

Works with: Claude Code, Codex CLI, Cursor, Antigravity, Copilot CLI, opencode.

## Tags

- Runs on your computer: It runs as a program on your machine, with your access.

## Security audits

- Gen Agent Trust Hub: Pass
- Socket: Pass
- Snyk: Pass

Installs: 1. Installs counted by skills.sh. [Open on skills.sh](https://www.skills.sh/ory/lumen/doctor)

## Source

[Open the source](https://github.com/ory/lumen/tree/HEAD/skills/doctor). Checked 2026-10-10. This summary may contain AI-generated text, so it can be wrong. Check the source before you rely on it.

## SKILL.md

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

1. Call the Lumen `health_check` tool to verify the embedding service is
   reachable.
2. Call the Lumen `index_status` tool with `path` or `cwd` set to the current
   working directory to check index freshness.
3. 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
4. If no index exists yet, explain that the Lumen `semantic_search` tool seeds
   the index on first use.
5. If the user wants eager indexing instead of waiting for the next search,
   suggest running `lumen index .` in the repository root.
6. 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.
````

- Previous: [offload-to-sandbox](https://syn4pse.dev/terminal/offload-to-sandbox.md)
- Next: [reindex](https://syn4pse.dev/terminal/ory-lumen-reindex.md)
- [Terminal](https://syn4pse.dev/terminal.md)
- [Suggest a change](mailto:terminal@syn4pse.dev?subject=Terminal%20suggestion)
