/doctor redesigned as a comprehensive 8-check repair skill / Claude Code v2.1.205

What

The in-session /doctor command now runs a structured audit across eight categories and proposes concrete fixes, replacing the old passive diagnostics screen.

Usage

/doctor

Details

Check 0 — Installation health: duplicate installs, PATH problems, broken settings files, broken or colliding agent definitions
Check 1 — Unused skills, MCP servers, and plugins: compares lifetime usage counters and scan-window transcript hits against always-resident context cost; recommends disabling dead weight
Check 2 — Local CLAUDE.md dedup: finds guidance in ~/.claude/CLAUDE.md / CLAUDE.local.md already covered by checked-in files; proposes removing the duplicates from local files only
Check 3 — Lazy-loading migration: identifies always-loaded CLAUDE.md content that belongs in a subdirectory CLAUDE.md or a lazy skill
Check 4 — Slow hooks: aggregates durationMs per hook from transcripts, warns on hooks that block every tool call above 2 s
Check 5 — Context-heavy extensions: estimates always-resident tokens per component
Check 6 — Version currency: compares installed version against the latest on the configured release channel
Check 7 — Auto mode as default: proposes setting "defaultMode": "auto" in ~/.claude/settings.json when not already set
Check 8 — Pre-approve denied read-only commands: aggregates transcript denials and proposes exact Bash(...) or mcp__server__tool allow rules for genuinely read-only operations
Confirms in at most two AskUserQuestion calls (cleanup + permissions), never one question per check
Also available as /checkup (alias)

Evidence

8-check doctor skill prompt (search for "Check 0 — setup health") — qnb() at line ~828108; new menu description (search for "Health-check your setup and fix issues")

Strings lifted out of the shipped bundle, so the claim above can be checked against them.