Doctor Skill Note: All ~/.claude/... paths in this guide respect CLAUDE CONFIG DIR when that environment variable is set. Task: Run Installation Diagnostics You are the OMC Doctor diagnose and fix installation issues. Step 1: Check Plugin Version Diagnosis : If no version installed: CRITICAL plugin not installed If INSTALLED != LATEST: WARN outdated plugin If multiple versions exist: WARN stale cache Step 2: Check for Legacy Hooks in settings.json Read both ${CLAUDE CONFIG DIR: ~/.claude}/settings.json (profile level) and ./.claude/settings.json (project level) and check if there's a "hooks" key with entries like: bash ${CLAUDE CONFIG DIR: $HOME/.claude}/hooks/keyword detector.sh bash ${CLAUDE CONFIG DIR: $HOME/.claude}/hooks/persistent mode.sh bash ${CLAUDE CONFIG DIR: $HOME/.claude}/hooks/session start.sh Diagnosis : If found: CRITICAL legacy hooks causing duplicates Step 3: Check for Legacy Bash Hook Scripts Diagnosis : If keyword detector.sh , persistent mode.sh , session start.sh , or stop continuation.sh exist: WARN legacy scripts (can cause confusion) Step 4: Check CLAUDE.md Diagnosis : If CLAUDE.md missing: CRITICAL CLAUDE.md not configured If <! OMC:START found in CLAUDE.md: OK If <! OMC:START found in a companion file (e.g. CLAUDE omc.md ): OK file split pattern detected If no OMC markers in CLAUDE.md or any companion file: WARN outdated CLAUDE.md If OMC:VERSION marker is missing from deterministic CLAUDE source scan (base + referenced companion): WARN cannot verify CLAUDE.md freshness If CLAUDE.md OMC version != Latest cached plugin version : WARN version drift detected (run omc update or omc setup ) Step 5: Check Ralph Runtime Prerequisites Ralph is an agent driven persistence loop, not a compiled program: its only hard runtime prerequisites are the Node runtime that executes OMC's hook scripts ( persistent mode.mjs , keyword detector.mjs ) and a writable config directory for .omc/state/ state files such as ralph state.json . Diagnosis : If Node runs and prints a version: OK Ralph runtime prerequisite present If node is missing or fails: CRITICAL OMC hooks and Ralph cannot run without Node (see https://nodejs.org for installers; nvm/fnm users need Node on the PATH of non interactive shells) If the config dir is not writable: WARN Ralph state persistence will fail until it is writable Step 6: Check for Stale Plugin Cache Diagnosis : If 1 version: WARN multiple cached versions (cleanup recommended) Step 7: Check for Legacy Curl Installed Content Check for legacy agents, commands, and skills installed via curl (before plugin system). Important : Only flag files whose names match actual plugin provided names. Do NOT flag user's custom agents/commands/skills that are unrelated to OMC. Diagnosis : If ~/.claude/agents/ exists with files matching plugin agent names: WARN legacy agents (now provided by plugin) If ~/.claude/commands/ exists with files matching plugin command names: WARN legacy commands (now provided by plugin) If ~/.claude/skills/ exists with files matching plugin skill names: WARN legacy skills (now provided by plugin) If custom files exist that do NOT match plugin names: OK these are user custom content, do not flag them Known plugin agent names (check agents/ for these): architect.md , document specialist.md , explore.md , executor.md , debugger.md , planner.md , analyst.md , critic.md , verifier.md , test engineer.md , designer.md , writer.md , qa tester.md , scientist.md , security reviewer.md , code reviewer.md , git master.md , code simplifier.md Known plugin skill names (check skills/ for these): ai slop cleaner , ask , autopilot , cancel , configure notifications , deep interview , deepinit , external context , hud , omc doctor , omc setup , plan , project session manager , ralph , ralplan , release , skill , team , visual verdict , wiki Known plugin command names (check commands/ for these): deepsearch.md Report Format After running all checks, output a report: Auto Fix (if user confirms) If issues found, ask user: "Would you like me to fix these issues automatically?" If yes, apply fixes: Fix: Legacy Hooks in settings.json Remove the "hooks" section from ${CLAUDE CONFIG DIR: ~/.claude}/settings.json (keep other settings intact) Fix: Legacy Bash Scripts Fix: Outdated Plugin Fix: Stale Cache (multiple versions) Fix: Missing/Outdated CLAUDE.md Fetch latest from GitHub and write to ${CLAUDE CONFIG DIR: ~/.claude}/CLAUDE.md : Fix: Legacy Curl Installed Content Remove legacy agents, commands, and skills directories (now provided by plugin): Note : Only remove if these contain oh my claudecode related files. If user has custom agents/commands/skills, warn them and ask before removing. Post Fix After applying fixes, inform user: Fixes applied. Restart Claude Code for changes to take effect.

omc-doctor