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

Get installed and latest versions (cross-platform)

node -e "const p=require('path'),f=require('fs'),h=require('os').homedir(),d=process.env.CLAUDE_CONFIG_DIR||p.join(h,'.claude'),b=p.join(d,'plugins','cache','omc','oh-my-claudecode');try{const v=f.readdirSync(b).filter(x=>/^\d/.test(x)).sort (( a , c ) =

a.localeCompare ( c , void 0 , {numeric : true} )) ;console.log('Installed:',v.length?v[v.length-1]:'(none)')}catch{console.log('Installed: (none)')}" npm view oh-my-claudecode version 2

/dev/null || echo "Latest: (unavailable)" 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/settings.json (profile-level) and ./.claude/settings.json (project-level) and check if there's a "hooks" key with entries like: bash $HOME/.claude/hooks/keyword-detector.sh bash $HOME/.claude/hooks/persistent-mode.sh bash $HOME/.claude/hooks/session-start.sh Diagnosis : If found: CRITICAL - legacy hooks causing duplicates Step 3: Check for Legacy Bash Hook Scripts ls -la ~/.claude/hooks/*.sh 2

/dev/null 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

Check if CLAUDE.md exists

ls -la ~/.claude/CLAUDE.md 2

/dev/null

Check for OMC markers ( is the canonical marker)

grep -q "" ~/.claude/CLAUDE.md 2

/dev/null && echo "Has OMC config" || echo "Missing OMC config in CLAUDE.md"

Check companion files for file-split pattern (e.g. CLAUDE-omc.md)

ls ~/.claude/CLAUDE-*.md 2

/dev/null for f in ~/.claude/CLAUDE-*.md ; do [ -f " $f " ] && grep -q "" " $f " 2

/dev/null && echo "Has OMC config in companion: $f " done

Check if CLAUDE.md references a companion file

grep -o "CLAUDE-[^ )]*.md" ~/.claude/CLAUDE.md 2

/dev/null Diagnosis : If CLAUDE.md missing: CRITICAL - CLAUDE.md not configured If

found in CLAUDE.md: OK If

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 Step 5: Check for Stale Plugin Cache

Count versions in cache (cross-platform)

node

-e

"const p=require('path'),f=require('fs'),h=require('os').homedir(),d=process.env.CLAUDE_CONFIG_DIR||p.join(h,'.claude'),b=p.join(d,'plugins','cache','omc','oh-my-claudecode');try{const v=f.readdirSync(b).filter(x=>/^\d/.test(x));console.log(v.length+' version(s):',v.join(', '))}catch{console.log('0 versions')}"

Diagnosis

:

If > 1 version: WARN - multiple cached versions (cleanup recommended)

Step 6: 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.

Check for legacy agents directory

ls -la ~/.claude/agents/ 2

/dev/null

Check for legacy commands directory

ls -la ~/.claude/commands/ 2

/dev/null

Check for legacy skills directory

ls -la ~/.claude/skills/ 2

/dev/null 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): ask-codex , ask-gemini , autopilot , cancel , ccg , configure-notifications , deep-interview , deepinit , external-context , hud , learn-about-omc , learner , mcp-setup , note , omc-doctor , omc-help , omc-setup , omc-teams , plan , project-session-manager , ralph , ralph-init , ralplan , release , sciomc , skill , team , trace , ultraqa , ultrawork , writer-memory Known plugin command names (check commands/ for these): ultrawork.md , deepsearch.md Report Format After running all checks, output a report:

OMC Doctor Report

Summary

[HEALTHY / ISSUES FOUND]

Checks