# Mlx Doctor

> Diagnose local model inventories, wiring drift, and endpoint health.

- Skill: `cavi-ai/mlx-doctor-2` (Agent Skill, multi-file: 45 files)
- Install (CLI): `npx skillmds@latest add cavi-ai/mlx-doctor-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/cavi-ai/mlx-doctor-2/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: cavi-ai (https://skillmd.com/u/cavi-ai)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/cavi-ai/mlx-doctor-2

---


Use `$mlx-agent:mlx-doctor` to invoke this installed Codex skill explicitly. Codex does not support custom `/mlx-*` slash commands.

# MLX Doctor

Resolve `<skill-dir>` as the absolute directory containing this SKILL.md. Never resolve the bundled executable from the shell working directory.

canonical capability ID: mlx-agent.doctor

Run the read-only model diagnostics:

`python3 <skill-dir>/scripts/mlx-agent doctor models --json`

Present the inventory, drift findings, and endpoint health as returned. Doctor must not delete, move, or repair anything; the confirmation-gated prune of incomplete cache snapshots requires an explicit reviewed preview from the user first.