[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M75FVCKG5YWQSYJF2BZC3X0R":3,"skill-same:01M75FVCKG5YWQSYJF2BZC3X0R":46},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":21,"frontMatter":22,"refName":23,"commitSha":24,"skillDirectory":25,"forksCount":26,"repositoryHtmlUrl":27,"repositoryHomepageUrl":28,"ownerHtmlUrl":29,"ownerBlogUrl":30,"ownerDescription":6,"updatedAt":31,"install":32,"resources":45},"01M75FVCKG5YWQSYJF2BZC3X0R","omc-doctor",null,"Diagnose and fix oh-my-claudecode installation issues","agisota\u002Fold-one","agisota","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F121413592?v=4","01M75B4BRNT67EC1NDRT8QZEP2","01M75B4BS7QR9VP580MSCPTS3X",3,"MIT","https:\u002F\u002Fgithub.com\u002Fagisota\u002Fold-one\u002Fblob\u002Fmain\u002Fskills\u002Foh-my-claudecode\u002Fskills\u002Fomc-doctor\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: omc-doctor\ndescription: Diagnose and fix oh-my-claudecode installation issues\nlevel: 3\n---\n\n# Doctor Skill\n\nNote: All `~\u002F.claude\u002F...` paths in this guide respect `CLAUDE_CONFIG_DIR` when that environment variable is set.\n\n## Task: Run Installation Diagnostics\n\nYou are the OMC Doctor - diagnose and fix installation issues.\n\n### Step 1: Check Plugin Version\n\n```bash\n# Get installed and latest versions (cross-platform)\nnode -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=>\u002F^\\d\u002F.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)')}\"\nnpm view oh-my-claudecode version 2>\u002Fdev\u002Fnull || echo \"Latest: (unavailable)\"\n```\n\n**Diagnosis**:\n- If no version installed: CRITICAL - plugin not installed\n- If INSTALLED != LATEST: WARN - outdated plugin\n- If multiple versions exist: WARN - stale cache\n\n### Step 2: Check for Legacy Hooks in settings.json\n\nRead both `${CLAUDE_CONFIG_DIR:-~\u002F.claude}\u002Fsettings.json` (profile-level) and `.\u002F.claude\u002Fsettings.json` (project-level) and check if there's a `\"hooks\"` key with entries like:\n- `bash ${CLAUDE_CONFIG_DIR:-$HOME\u002F.claude}\u002Fhooks\u002Fkeyword-detector.sh`\n- `bash ${CLAUDE_CONFIG_DIR:-$HOME\u002F.claude}\u002Fhooks\u002Fpersistent-mode.sh`\n- `bash ${CLAUDE_CONFIG_DIR:-$HOME\u002F.claude}\u002Fhooks\u002Fsession-start.sh`\n\n**Diagnosis**:\n- If found: CRITICAL - legacy hooks causing duplicates\n\n### Step 3: Check for Legacy Bash Hook Scripts\n\n```bash\nls -la \"${CLAUDE_CONFIG_DIR:-$HOME\u002F.claude}\"\u002Fhooks\u002F*.sh 2>\u002Fdev\u002Fnull\n```\n\n**Diagnosis**:\n- If `keyword-detector.sh`, `persistent-mode.sh`, `session-start.sh`, or `stop-continuation.sh` exist: WARN - legacy scripts (can cause confusion)\n\n### Step 4: Check CLAUDE.md\n\n```bash\n# Check if CLAUDE.md exists\nls -la \"${CLAUDE_CONFIG_DIR:-$HOME\u002F.claude}\"\u002FCLAUDE.md 2>\u002Fdev\u002Fnull\n\n# Check for OMC markers (\u003C!-- OMC:START --> is the canonical marker)\ngrep -q \"\u003C!-- OMC:START -->\" \"${CLAUDE_CONFIG_DIR:-$HOME\u002F.claude}\u002FCLAUDE.md\" 2>\u002Fdev\u002Fnull && echo \"Has OMC config\" || echo \"Missing OMC config in CLAUDE.md\"\n\n# Check CLAUDE.md (or deterministic companion) version marker and compare with latest installed plugin cache version\nnode -e \"const p=require('path'),f=require('fs'),h=require('os').homedir(),d=process.env.CLAUDE_CONFIG_DIR||p.join(h,'.claude');const base=p.join(d,'CLAUDE.md');let baseContent='';try{baseContent=f.readFileSync(base,'utf8')}catch{};let candidates=[base];let referenced='';const importMatch=baseContent.match(\u002FCLAUDE-[^ )]*\\\\.md\u002F);if(importMatch){referenced=p.join(d,importMatch[0]);candidates.push(referenced)}else{const defaultCompanion=p.join(d,'CLAUDE-omc.md');if(f.existsSync(defaultCompanion))candidates.push(defaultCompanion);try{const others=f.readdirSync(d).filter(n=>\u002F^CLAUDE-.*\\\\.md$\u002Fi.test(n)).sort().map(n=>p.join(d,n));for(const o of others){if(candidates.includes(o)===false)candidates.push(o)}}catch{}};let claudeV='(missing)';let claudeSource='(none)';for(const file of candidates){try{const c=f.readFileSync(file,'utf8');const m=c.match(\u002F\u003C!--\\\\s*OMC:VERSION:([^\\\\s]+)\\\\s*-->\u002Fi);if(m){claudeV=m[1];claudeSource=file;break}}catch{}};if(claudeV==='(missing)'&&candidates.length>0){claudeV='(missing marker)';claudeSource='scanned deterministic CLAUDE sources';};let pluginV='(none)';try{const b=p.join(d,'plugins','cache','omc','oh-my-claudecode');const v=f.readdirSync(b).filter(x=>\u002F^\\\\d\u002F.test(x)).sort((a,c)=>a.localeCompare(c,void 0,{numeric:true}));pluginV=v.length?v[v.length-1]:'(none)';}catch{};console.log('CLAUDE.md OMC version:',claudeV);console.log('OMC version source:',claudeSource);console.log('Latest cached plugin version:',pluginV);if(claudeV==='(missing)'||claudeV==='(missing marker)'||pluginV==='(none)'){console.log('VERSION CHECK SKIPPED: missing CLAUDE marker or plugin cache')}else if(claudeV===pluginV){console.log('VERSION MATCH: CLAUDE and plugin cache are aligned')}else{console.log('VERSION DRIFT: CLAUDE.md and plugin versions differ')}\"\n\n# Check companion files for file-split pattern (e.g. CLAUDE-omc.md)\nfind \"${CLAUDE_CONFIG_DIR:-$HOME\u002F.claude}\" -maxdepth 1 -type f -name 'CLAUDE-*.md' -print 2>\u002Fdev\u002Fnull\nwhile IFS= read -r f; do\n  grep -q \"\u003C!-- OMC:START -->\" \"$f\" 2>\u002Fdev\u002Fnull && echo \"Has OMC config in companion: $f\"\ndone \u003C \u003C(find \"${CLAUDE_CONFIG_DIR:-$HOME\u002F.claude}\" -maxdepth 1 -type f -name 'CLAUDE-*.md' -print 2>\u002Fdev\u002Fnull)\n\n# Check if CLAUDE.md references a companion file\ngrep -o \"CLAUDE-[^ )]*\\.md\" \"${CLAUDE_CONFIG_DIR:-$HOME\u002F.claude}\u002FCLAUDE.md\" 2>\u002Fdev\u002Fnull\n```\n\n**Diagnosis**:\n- If CLAUDE.md missing: CRITICAL - CLAUDE.md not configured\n- If `\u003C!-- OMC:START -->` found in CLAUDE.md: OK\n- If `\u003C!-- OMC:START -->` found in a companion file (e.g. `CLAUDE-omc.md`): OK - file-split pattern detected\n- If no OMC markers in CLAUDE.md or any companion file: WARN - outdated CLAUDE.md\n- If `OMC:VERSION` marker is missing from deterministic CLAUDE source scan (base + referenced companion): WARN - cannot verify CLAUDE.md freshness\n- If `CLAUDE.md OMC version` != `Latest cached plugin version`: WARN - version drift detected (run `omc update` or `omc setup`)\n\n### Step 5: Check for Stale Plugin Cache\n\n```bash\n# Count versions in cache (cross-platform)\nnode -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=>\u002F^\\d\u002F.test(x));console.log(v.length+' version(s):',v.join(', '))}catch{console.log('0 versions')}\"\n```\n\n**Diagnosis**:\n- If > 1 version: WARN - multiple cached versions (cleanup recommended)\n\n### Step 6: Check for Legacy Curl-Installed Content\n\nCheck for legacy agents, commands, and skills installed via curl (before plugin system).\n**Important**: Only flag files whose names match actual plugin-provided names. Do NOT flag user's custom agents\u002Fcommands\u002Fskills that are unrelated to OMC.\n\n```bash\n# Check for legacy agents directory\nls -la \"${CLAUDE_CONFIG_DIR:-$HOME\u002F.claude}\"\u002Fagents\u002F 2>\u002Fdev\u002Fnull\n\n# Check for legacy commands directory\nls -la \"${CLAUDE_CONFIG_DIR:-$HOME\u002F.claude}\"\u002Fcommands\u002F 2>\u002Fdev\u002Fnull\n\n# Check for legacy skills directory\nls -la \"${CLAUDE_CONFIG_DIR:-$HOME\u002F.claude}\"\u002Fskills\u002F 2>\u002Fdev\u002Fnull\n```\n\n**Diagnosis**:\n- If `~\u002F.claude\u002Fagents\u002F` exists with files matching plugin agent names: WARN - legacy agents (now provided by plugin)\n- If `~\u002F.claude\u002Fcommands\u002F` exists with files matching plugin command names: WARN - legacy commands (now provided by plugin)\n- If `~\u002F.claude\u002Fskills\u002F` exists with files matching plugin skill names: WARN - legacy skills (now provided by plugin)\n- If custom files exist that do NOT match plugin names: OK - these are user custom content, do not flag them\n\n**Known plugin agent names** (check agents\u002F for these):\n`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`\n\n**Known plugin skill names** (check skills\u002F for these):\n`ai-slop-cleaner`, `ask`, `autopilot`, `cancel`, `ccg`, `configure-notifications`, `deep-interview`, `deepinit`, `external-context`, `hud`, `learner`, `mcp-setup`, `omc-doctor`, `omc-setup`, `omc-teams`, `plan`, `project-session-manager`, `ralph`, `ralplan`, `release`, `sciomc`, `setup`, `skill`, `team`, `ultraqa`, `ultrawork`, `visual-verdict`, `writer-memory`\n\n**Known plugin command names** (check commands\u002F for these):\n`ultrawork.md`, `deepsearch.md`\n\n---\n\n## Report Format\n\nAfter running all checks, output a report:\n\n```\n## OMC Doctor Report\n\n### Summary\n[HEALTHY \u002F ISSUES FOUND]\n\n### Checks\n\n| Check | Status | Details |\n|-------|--------|---------|\n| Plugin Version | OK\u002FWARN\u002FCRITICAL | ... |\n| Legacy Hooks (settings.json) | OK\u002FCRITICAL | ... |\n| Legacy Scripts (~\u002F.claude\u002Fhooks\u002F) | OK\u002FWARN | ... |\n| CLAUDE.md | OK\u002FWARN\u002FCRITICAL | ... |\n| Plugin Cache | OK\u002FWARN | ... |\n| Legacy Agents (~\u002F.claude\u002Fagents\u002F) | OK\u002FWARN | ... |\n| Legacy Commands (~\u002F.claude\u002Fcommands\u002F) | OK\u002FWARN | ... |\n| Legacy Skills (~\u002F.claude\u002Fskills\u002F) | OK\u002FWARN | ... |\n\n### Issues Found\n1. [Issue description]\n2. [Issue description]\n\n### Recommended Fixes\n[List fixes based on issues]\n```\n\n---\n\n## Auto-Fix (if user confirms)\n\nIf issues found, ask user: \"Would you like me to fix these issues automatically?\"\n\nIf yes, apply fixes:\n\n### Fix: Legacy Hooks in settings.json\nRemove the `\"hooks\"` section from `${CLAUDE_CONFIG_DIR:-~\u002F.claude}\u002Fsettings.json` (keep other settings intact)\n\n### Fix: Legacy Bash Scripts\n```bash\nrm -f \"${CLAUDE_CONFIG_DIR:-$HOME\u002F.claude}\"\u002Fhooks\u002Fkeyword-detector.sh\nrm -f \"${CLAUDE_CONFIG_DIR:-$HOME\u002F.claude}\"\u002Fhooks\u002Fpersistent-mode.sh\nrm -f \"${CLAUDE_CONFIG_DIR:-$HOME\u002F.claude}\"\u002Fhooks\u002Fsession-start.sh\nrm -f \"${CLAUDE_CONFIG_DIR:-$HOME\u002F.claude}\"\u002Fhooks\u002Fstop-continuation.sh\n```\n\n### Fix: Outdated Plugin\n```bash\n# Clear plugin cache (cross-platform)\nnode -e \"const p=require('path'),f=require('fs'),d=process.env.CLAUDE_CONFIG_DIR||p.join(require('os').homedir(),'.claude'),b=p.join(d,'plugins','cache','omc','oh-my-claudecode');try{f.rmSync(b,{recursive:true,force:true});console.log('Plugin cache cleared. Restart Claude Code to fetch latest version.')}catch{console.log('No plugin cache found')}\"\n```\n\n### Fix: Stale Cache (multiple versions)\n```bash\n# Keep only latest version (cross-platform)\nnode -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=>\u002F^\\d\u002F.test(x)).sort((a,c)=>a.localeCompare(c,void 0,{numeric:true}));v.slice(0,-1).forEach(x=>f.rmSync(p.join(b,x),{recursive:true,force:true}));console.log('Removed',v.length-1,'old version(s)')}catch(e){console.log('No cache to clean')}\"\n```\n\n### Fix: Missing\u002FOutdated CLAUDE.md\nFetch latest from GitHub and write to `${CLAUDE_CONFIG_DIR:-~\u002F.claude}\u002FCLAUDE.md`:\n```\nWebFetch(url: \"https:\u002F\u002Fraw.githubusercontent.com\u002FYeachan-Heo\u002Foh-my-claudecode\u002Fmain\u002Fdocs\u002FCLAUDE.md\", prompt: \"Return the complete raw markdown content exactly as-is\")\n```\n\n### Fix: Legacy Curl-Installed Content\n\nRemove legacy agents, commands, and skills directories (now provided by plugin):\n\n```bash\n# Backup first (optional - ask user)\n# mv \"${CLAUDE_CONFIG_DIR:-$HOME\u002F.claude}\"\u002Fagents \"${CLAUDE_CONFIG_DIR:-$HOME\u002F.claude}\"\u002Fagents.bak\n# mv \"${CLAUDE_CONFIG_DIR:-$HOME\u002F.claude}\"\u002Fcommands \"${CLAUDE_CONFIG_DIR:-$HOME\u002F.claude}\"\u002Fcommands.bak\n# mv \"${CLAUDE_CONFIG_DIR:-$HOME\u002F.claude}\"\u002Fskills \"${CLAUDE_CONFIG_DIR:-$HOME\u002F.claude}\"\u002Fskills.bak\n\n# Or remove directly\nrm -rf \"${CLAUDE_CONFIG_DIR:-$HOME\u002F.claude}\"\u002Fagents\nrm -rf \"${CLAUDE_CONFIG_DIR:-$HOME\u002F.claude}\"\u002Fcommands\nrm -rf \"${CLAUDE_CONFIG_DIR:-$HOME\u002F.claude}\"\u002Fskills\n```\n\n**Note**: Only remove if these contain oh-my-claudecode-related files. If user has custom agents\u002Fcommands\u002Fskills, warn them and ask before removing.\n\n---\n\n## Post-Fix\n\nAfter applying fixes, inform user:\n> Fixes applied. **Restart Claude Code** for changes to take effect.\n","# Doctor Skill\n\nNote: All `~\u002F.claude\u002F...` paths in this guide respect `CLAUDE_CONFIG_DIR` when that environment variable is set.\n\n## Task: Run Installation Diagnostics\n\nYou are the OMC Doctor - diagnose and fix installation issues.\n\n### Step 1: Check Plugin Version\n\n```bash\n# Get installed and latest versions (cross-platform)\nnode -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=>\u002F^\\d\u002F.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)')}\"\nnpm view oh-my-claudecode version 2>\u002Fdev\u002Fnull || echo \"Latest: (unavailable)\"\n```\n\n**Diagnosis**:\n- If no version installed: CRITICAL - plugin not installed\n- If INSTALLED != LATEST: WARN - outdated plugin\n- If multiple versions exist: WARN - stale cache\n\n### Step 2: Check for Legacy Hooks in settings.json\n\nRead both `${CLAUDE_CONFIG_DIR:-~\u002F.claude}\u002Fsettings.json` (profile-level) and `.\u002F.claude\u002Fsettings.json` (project-level) and check if there's a `\"hooks\"` key with entries like:\n- `bash ${CLAUDE_CONFIG_DIR:-$HOME\u002F.claude}\u002Fhooks\u002Fkeyword-detector.sh`\n- `bash ${CLAUDE_CONFIG_DIR:-$HOME\u002F.claude}\u002Fhooks\u002Fpersistent-mode.sh`\n- `bash ${CLAUDE_CONFIG_DIR:-$HOME\u002F.claude}\u002Fhooks\u002Fsession-start.sh`\n\n**Diagnosis**:\n- If found: CRITICAL - legacy hooks causing duplicates\n\n### Step 3: Check for Legacy Bash Hook Scripts\n\n```bash\nls -la \"${CLAUDE_CONFIG_DIR:-$HOME\u002F.claude}\"\u002Fhooks\u002F*.sh 2>\u002Fdev\u002Fnull\n```\n\n**Diagnosis**:\n- If `keyword-detector.sh`, `persistent-mode.sh`, `session-start.sh`, or `stop-continuation.sh` exist: WARN - legacy scripts (can cause confusion)\n\n### Step 4: Check CLAUDE.md\n\n```bash\n# Check if CLAUDE.md exists\nls -la \"${CLAUDE_CONFIG_DIR:-$HOME\u002F.claude}\"\u002FCLAUDE.md 2>\u002Fdev\u002Fnull\n\n# Check for OMC markers (\u003C!-- OMC:START --> is the canonical marker)\ngrep -q \"\u003C!-- OMC:START -->\" \"${CLAUDE_CONFIG_DIR:-$HOME\u002F.claude}\u002FCLAUDE.md\" 2>\u002Fdev\u002Fnull && echo \"Has OMC config\" || echo \"Missing OMC config in CLAUDE.md\"\n\n# Check CLAUDE.md (or deterministic companion) version marker and compare with latest installed plugin cache version\nnode -e \"const p=require('path'),f=require('fs'),h=require('os').homedir(),d=process.env.CLAUDE_CONFIG_DIR||p.join(h,'.claude');const base=p.join(d,'CLAUDE.md');let baseContent='';try{baseContent=f.readFileSync(base,'utf8')}catch{};let candidates=[base];let referenced='';const importMatch=baseContent.match(\u002FCLAUDE-[^ )]*\\\\.md\u002F);if(importMatch){referenced=p.join(d,importMatch[0]);candidates.push(referenced)}else{const defaultCompanion=p.join(d,'CLAUDE-omc.md');if(f.existsSync(defaultCompanion))candidates.push(defaultCompanion);try{const others=f.readdirSync(d).filter(n=>\u002F^CLAUDE-.*\\\\.md$\u002Fi.test(n)).sort().map(n=>p.join(d,n));for(const o of others){if(candidates.includes(o)===false)candidates.push(o)}}catch{}};let claudeV='(missing)';let claudeSource='(none)';for(const file of candidates){try{const c=f.readFileSync(file,'utf8');const m=c.match(\u002F\u003C!--\\\\s*OMC:VERSION:([^\\\\s]+)\\\\s*-->\u002Fi);if(m){claudeV=m[1];claudeSource=file;break}}catch{}};if(claudeV==='(missing)'&&candidates.length>0){claudeV='(missing marker)';claudeSource='scanned deterministic CLAUDE sources';};let pluginV='(none)';try{const b=p.join(d,'plugins','cache','omc','oh-my-claudecode');const v=f.readdirSync(b).filter(x=>\u002F^\\\\d\u002F.test(x)).sort((a,c)=>a.localeCompare(c,void 0,{numeric:true}));pluginV=v.length?v[v.length-1]:'(none)';}catch{};console.log('CLAUDE.md OMC version:',claudeV);console.log('OMC version source:',claudeSource);console.log('Latest cached plugin version:',pluginV);if(claudeV==='(missing)'||claudeV==='(missing marker)'||pluginV==='(none)'){console.log('VERSION CHECK SKIPPED: missing CLAUDE marker or plugin cache')}else if(claudeV===pluginV){console.log('VERSION MATCH: CLAUDE and plugin cache are aligned')}else{console.log('VERSION DRIFT: CLAUDE.md and plugin versions differ')}\"\n\n# Check companion files for file-split pattern (e.g. CLAUDE-omc.md)\nfind \"${CLAUDE_CONFIG_DIR:-$HOME\u002F.claude}\" -maxdepth 1 -type f -name 'CLAUDE-*.md' -print 2>\u002Fdev\u002Fnull\nwhile IFS= read -r f; do\n  grep -q \"\u003C!-- OMC:START -->\" \"$f\" 2>\u002Fdev\u002Fnull && echo \"Has OMC config in companion: $f\"\ndone \u003C \u003C(find \"${CLAUDE_CONFIG_DIR:-$HOME\u002F.claude}\" -maxdepth 1 -type f -name 'CLAUDE-*.md' -print 2>\u002Fdev\u002Fnull)\n\n# Check if CLAUDE.md references a companion file\ngrep -o \"CLAUDE-[^ )]*\\.md\" \"${CLAUDE_CONFIG_DIR:-$HOME\u002F.claude}\u002FCLAUDE.md\" 2>\u002Fdev\u002Fnull\n```\n\n**Diagnosis**:\n- If CLAUDE.md missing: CRITICAL - CLAUDE.md not configured\n- If `\u003C!-- OMC:START -->` found in CLAUDE.md: OK\n- If `\u003C!-- OMC:START -->` found in a companion file (e.g. `CLAUDE-omc.md`): OK - file-split pattern detected\n- If no OMC markers in CLAUDE.md or any companion file: WARN - outdated CLAUDE.md\n- If `OMC:VERSION` marker is missing from deterministic CLAUDE source scan (base + referenced companion): WARN - cannot verify CLAUDE.md freshness\n- If `CLAUDE.md OMC version` != `Latest cached plugin version`: WARN - version drift detected (run `omc update` or `omc setup`)\n\n### Step 5: Check for Stale Plugin Cache\n\n```bash\n# Count versions in cache (cross-platform)\nnode -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=>\u002F^\\d\u002F.test(x));console.log(v.length+' version(s):',v.join(', '))}catch{console.log('0 versions')}\"\n```\n\n**Diagnosis**:\n- If > 1 version: WARN - multiple cached versions (cleanup recommended)\n\n### Step 6: Check for Legacy Curl-Installed Content\n\nCheck for legacy agents, commands, and skills installed via curl (before plugin system).\n**Important**: Only flag files whose names match actual plugin-provided names. Do NOT flag user's custom agents\u002Fcommands\u002Fskills that are unrelated to OMC.\n\n```bash\n# Check for legacy agents directory\nls -la \"${CLAUDE_CONFIG_DIR:-$HOME\u002F.claude}\"\u002Fagents\u002F 2>\u002Fdev\u002Fnull\n\n# Check for legacy commands directory\nls -la \"${CLAUDE_CONFIG_DIR:-$HOME\u002F.claude}\"\u002Fcommands\u002F 2>\u002Fdev\u002Fnull\n\n# Check for legacy skills directory\nls -la \"${CLAUDE_CONFIG_DIR:-$HOME\u002F.claude}\"\u002Fskills\u002F 2>\u002Fdev\u002Fnull\n```\n\n**Diagnosis**:\n- If `~\u002F.claude\u002Fagents\u002F` exists with files matching plugin agent names: WARN - legacy agents (now provided by plugin)\n- If `~\u002F.claude\u002Fcommands\u002F` exists with files matching plugin command names: WARN - legacy commands (now provided by plugin)\n- If `~\u002F.claude\u002Fskills\u002F` exists with files matching plugin skill names: WARN - legacy skills (now provided by plugin)\n- If custom files exist that do NOT match plugin names: OK - these are user custom content, do not flag them\n\n**Known plugin agent names** (check agents\u002F for these):\n`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`\n\n**Known plugin skill names** (check skills\u002F for these):\n`ai-slop-cleaner`, `ask`, `autopilot`, `cancel`, `ccg`, `configure-notifications`, `deep-interview`, `deepinit`, `external-context`, `hud`, `learner`, `mcp-setup`, `omc-doctor`, `omc-setup`, `omc-teams`, `plan`, `project-session-manager`, `ralph`, `ralplan`, `release`, `sciomc`, `setup`, `skill`, `team`, `ultraqa`, `ultrawork`, `visual-verdict`, `writer-memory`\n\n**Known plugin command names** (check commands\u002F for these):\n`ultrawork.md`, `deepsearch.md`\n\n---\n\n## Report Format\n\nAfter running all checks, output a report:\n\n```\n## OMC Doctor Report\n\n### Summary\n[HEALTHY \u002F ISSUES FOUND]\n\n### Checks\n\n| Check | Status | Details |\n|-------|--------|---------|\n| Plugin Version | OK\u002FWARN\u002FCRITICAL | ... |\n| Legacy Hooks (settings.json) | OK\u002FCRITICAL | ... |\n| Legacy Scripts (~\u002F.claude\u002Fhooks\u002F) | OK\u002FWARN | ... |\n| CLAUDE.md | OK\u002FWARN\u002FCRITICAL | ... |\n| Plugin Cache | OK\u002FWARN | ... |\n| Legacy Agents (~\u002F.claude\u002Fagents\u002F) | OK\u002FWARN | ... |\n| Legacy Commands (~\u002F.claude\u002Fcommands\u002F) | OK\u002FWARN | ... |\n| Legacy Skills (~\u002F.claude\u002Fskills\u002F) | OK\u002FWARN | ... |\n\n### Issues Found\n1. [Issue description]\n2. [Issue description]\n\n### Recommended Fixes\n[List fixes based on issues]\n```\n\n---\n\n## Auto-Fix (if user confirms)\n\nIf issues found, ask user: \"Would you like me to fix these issues automatically?\"\n\nIf yes, apply fixes:\n\n### Fix: Legacy Hooks in settings.json\nRemove the `\"hooks\"` section from `${CLAUDE_CONFIG_DIR:-~\u002F.claude}\u002Fsettings.json` (keep other settings intact)\n\n### Fix: Legacy Bash Scripts\n```bash\nrm -f \"${CLAUDE_CONFIG_DIR:-$HOME\u002F.claude}\"\u002Fhooks\u002Fkeyword-detector.sh\nrm -f \"${CLAUDE_CONFIG_DIR:-$HOME\u002F.claude}\"\u002Fhooks\u002Fpersistent-mode.sh\nrm -f \"${CLAUDE_CONFIG_DIR:-$HOME\u002F.claude}\"\u002Fhooks\u002Fsession-start.sh\nrm -f \"${CLAUDE_CONFIG_DIR:-$HOME\u002F.claude}\"\u002Fhooks\u002Fstop-continuation.sh\n```\n\n### Fix: Outdated Plugin\n```bash\n# Clear plugin cache (cross-platform)\nnode -e \"const p=require('path'),f=require('fs'),d=process.env.CLAUDE_CONFIG_DIR||p.join(require('os').homedir(),'.claude'),b=p.join(d,'plugins','cache','omc','oh-my-claudecode');try{f.rmSync(b,{recursive:true,force:true});console.log('Plugin cache cleared. Restart Claude Code to fetch latest version.')}catch{console.log('No plugin cache found')}\"\n```\n\n### Fix: Stale Cache (multiple versions)\n```bash\n# Keep only latest version (cross-platform)\nnode -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=>\u002F^\\d\u002F.test(x)).sort((a,c)=>a.localeCompare(c,void 0,{numeric:true}));v.slice(0,-1).forEach(x=>f.rmSync(p.join(b,x),{recursive:true,force:true}));console.log('Removed',v.length-1,'old version(s)')}catch(e){console.log('No cache to clean')}\"\n```\n\n### Fix: Missing\u002FOutdated CLAUDE.md\nFetch latest from GitHub and write to `${CLAUDE_CONFIG_DIR:-~\u002F.claude}\u002FCLAUDE.md`:\n```\nWebFetch(url: \"https:\u002F\u002Fraw.githubusercontent.com\u002FYeachan-Heo\u002Foh-my-claudecode\u002Fmain\u002Fdocs\u002FCLAUDE.md\", prompt: \"Return the complete raw markdown content exactly as-is\")\n```\n\n### Fix: Legacy Curl-Installed Content\n\nRemove legacy agents, commands, and skills directories (now provided by plugin):\n\n```bash\n# Backup first (optional - ask user)\n# mv \"${CLAUDE_CONFIG_DIR:-$HOME\u002F.claude}\"\u002Fagents \"${CLAUDE_CONFIG_DIR:-$HOME\u002F.claude}\"\u002Fagents.bak\n# mv \"${CLAUDE_CONFIG_DIR:-$HOME\u002F.claude}\"\u002Fcommands \"${CLAUDE_CONFIG_DIR:-$HOME\u002F.claude}\"\u002Fcommands.bak\n# mv \"${CLAUDE_CONFIG_DIR:-$HOME\u002F.claude}\"\u002Fskills \"${CLAUDE_CONFIG_DIR:-$HOME\u002F.claude}\"\u002Fskills.bak\n\n# Or remove directly\nrm -rf \"${CLAUDE_CONFIG_DIR:-$HOME\u002F.claude}\"\u002Fagents\nrm -rf \"${CLAUDE_CONFIG_DIR:-$HOME\u002F.claude}\"\u002Fcommands\nrm -rf \"${CLAUDE_CONFIG_DIR:-$HOME\u002F.claude}\"\u002Fskills\n```\n\n**Note**: Only remove if these contain oh-my-claudecode-related files. If user has custom agents\u002Fcommands\u002Fskills, warn them and ask before removing.\n\n---\n\n## Post-Fix\n\nAfter applying fixes, inform user:\n> Fixes applied. **Restart Claude Code** for changes to take effect.\n",{"name":5,"level":13,"description":7},"main","f37de8f681f0c0ca0e0ebab6e5fddf764ca7553d","skills\u002Foh-my-claudecode\u002Fskills\u002Fomc-doctor",1,"https:\u002F\u002Fgithub.com\u002Fagisota\u002Fold-one","https:\u002F\u002Fagisota.github.io\u002Fold-one\u002F","https:\u002F\u002Fgithub.com\u002Fagisota","pzd.world","2026-07-04 22:32:06",{"source":8,"skillName":5,"commands":33,"prompt":43,"zipAvailable":44},[34,37,40],{"tool":35,"command":36},"npx","npx skills add agisota\u002Fold-one --skill omc-doctor",{"tool":38,"command":39},"bunx","bunx skills add agisota\u002Fold-one --skill omc-doctor",{"tool":41,"command":42},"pnpm","pnpm dlx skills add agisota\u002Fold-one --skill omc-doctor","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fagisota\u002Fold-one\u002Fblob\u002Fmain\u002Fskills\u002Foh-my-claudecode\u002Fskills\u002Fomc-doctor\u002FSKILL.md",true,[],[47,54,61,70,77,84],{"skillNo":48,"name":49,"nameZh":6,"description":50,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":51,"categories":52,"keywords":53,"publishedAt":18},"01M75KRGZWQWE9JDBS6RX42NWV","zoom-out","Tell the agent to zoom out and give broader context or a higher-level perspective. Use when you're unfamiliar with a section of code or need to understand how it fits into the bigger picture.","https:\u002F\u002Fgithub.com\u002Fagisota\u002Fold-one\u002Fblob\u002Fmain\u002Fskills\u002Fzoom-out\u002FSKILL.md",[],[],{"skillNo":55,"name":56,"nameZh":6,"description":57,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":58,"categories":59,"keywords":60,"publishedAt":18},"01M75KRCZHKE0ZYAQFFYHS0YNP","zeroize-audit","Detects missing zeroization of sensitive data in source code and identifies zeroization removed by compiler optimizations, with assembly-level analysis, and control-flow verification. Use for auditing C\u002FC++\u002FRust code handling secrets, keys, passwords, or other sensitive data.","https:\u002F\u002Fgithub.com\u002Fagisota\u002Fold-one\u002Fblob\u002Fmain\u002Fskills\u002Fzeroize-audit\u002FSKILL.md",[],[],{"skillNo":62,"name":63,"nameZh":6,"description":64,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":65,"licenseFileUrl":66,"sourceHtmlUrl":67,"categories":68,"keywords":69,"publishedAt":18},"01M75KR94KYQ30DTE1P9WNDAE0","yeet","Use only when the user explicitly asks to stage, commit, push, and open a GitHub pull request in one flow using the GitHub CLI (`gh`).","Apache-2.0","https:\u002F\u002Fgithub.com\u002Fagisota\u002Fold-one\u002Fblob\u002Fmain\u002Fskills\u002Fyeet\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002Fagisota\u002Fold-one\u002Fblob\u002Fmain\u002Fskills\u002Fyeet\u002FSKILL.md",[],[],{"skillNo":71,"name":72,"nameZh":6,"description":73,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":74,"categories":75,"keywords":76,"publishedAt":18},"01M75KR3H13YJ9QHMD49818FA1","yara-rule-authoring","Guides authoring of high-quality YARA-X detection rules for malware identification. Use when writing, reviewing, or optimizing YARA rules. Covers naming conventions, string selection, performance optimization, migration from legacy YARA, and false positive reduction. Triggers on: YARA, YARA-X, malware detection, threat hunting, IOC, signature, crx module, dex module.","https:\u002F\u002Fgithub.com\u002Fagisota\u002Fold-one\u002Fblob\u002Fmain\u002Fskills\u002Fyara-rule-authoring\u002FSKILL.md",[],[],{"skillNo":78,"name":79,"nameZh":6,"description":80,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":81,"categories":82,"keywords":83,"publishedAt":18},"01M75KQMPY8A4Y8XTDD2DT0M9T","x-twitter-growth","X\u002FTwitter growth engine for building audience, crafting viral content, and analyzing engagement. Use when the user wants to grow on X\u002FTwitter, write tweets or threads, analyze their X profile, research competitors on X, plan a posting strategy, or optimize engagement. Complements social-content (generic multi-platform) with X-specific depth: algorithm mechanics, thread engineering, reply strategy, profile optimization, and competitive intelligence via web search.","https:\u002F\u002Fgithub.com\u002Fagisota\u002Fold-one\u002Fblob\u002Fmain\u002Fskills\u002Fx-twitter-growth\u002FSKILL.md",[],[],{"skillNo":85,"name":86,"nameZh":6,"description":87,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":88,"categories":89,"keywords":90,"publishedAt":18},"01M75KQHNZ0ANZNJGZY6M8MDAK","x-api","X\u002FTwitter API integration for posting tweets, threads, reading timelines, search, and analytics. Covers OAuth auth patterns, rate limits, and platform-native content posting. Use when the user wants to interact with X programmatically.","https:\u002F\u002Fgithub.com\u002Fagisota\u002Fold-one\u002Fblob\u002Fmain\u002Fskills\u002Fx-api\u002FSKILL.md",[],[]]