# Mindex Doctor

> Diagnose MIndex installation, indexing, locking, privacy, and consistency problems. Use when MIndex memory is missing, stale, duplicated, or failing validation.

- Skill: `ericgrill/mindex-doctor` (Agent Skill)
- Install (CLI): `npx get-skill add ericgrill/mindex-doctor`
- Raw SKILL.md: https://api.skillmd.com/api/skills/ericgrill/mindex-doctor/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: EricGrill (https://skillmd.com/u/ericgrill)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/ericgrill/mindex-doctor

---


# Diagnose MIndex Memory

## Checks

1. Locate the managed MIndex block in `~/.claude/CLAUDE.md`.
2. Confirm the imported `CLAUDE.md`, `INDEX.md`, and maintenance scripts exist.
3. Run `tools/install.py --check`.
4. Run `tools/verify.py`.
5. Confirm `.memory.lock` is ignored by Git. Its existence is normal and does
   not mean the lock is held.
6. Check for untracked or staged files that look like credentials or private
   keys. Do not print their contents.
7. Check whether `INDEX.md` is stale without editing it directly.
8. Report exact failures, then apply non-destructive fixes.

Never delete a lock file to clear a suspected stale lock. Never reset, discard,
commit, or push user memory without explicit approval.

