Omc Doctor

When your oh-my-claudecode setup feels broken or outdated, this diagnostic skill runs seven checks to pinpoint the problem. It compares your installed plugin version against the latest release, hunts for legacy bash hooks that cause duplicate behavior, verifies your CLAUDE.md has the right OMC markers and version tags, confirms Ruby is installed for Ralph workflows, and flags stale cache or curl-installed content that's now redundant. The output tells you exactly what's critical, what's just a warning, and what needs cleanup. It's the first thing to run when OMC stops behaving or after you've upgraded and aren't sure everything migrated cleanly.

skills.sh installs: 891
GitHub stars: 40.7K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add yeachan-heo/oh-my-claudecode --skill omc-doctor --agent claude-code

Installs into .claude/skills of the current project.

Files

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-claude-sisyphus version 2>/dev/null || echo "Latest: (unavailable)"

Diagnosis: