omc-doctor

Diagnose and fix oh-my-claudecode installation issues in Claude Code environments.

1|Updated Apr 1, 2026
One-click install
npx skills add https://github.com/OliverOuyang/shuhe-work-skills --skill omc-doctor-oliverouyang
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: omc-doctor
Source: https://github.com/OliverOuyang/shuhe-work-skills/tree/main/skills/omc-doctor
Command: npx skills add https://github.com/OliverOuyang/shuhe-work-skills --skill omc-doctor-oliverouyang

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Diagnose and fix oh-my-claudecode installation issues.

Core Features & Use Cases

  • Automated diagnostics for plugin installation problems including version checks, legacy hooks, legacy scripts, CLAUDE.md configuration, and cache issues.
  • Guided remediation with safe rollback steps to restore a healthy OMC environment.
  • Use Case: When Claude Code reports plugin misconfiguration or duplicates, run omc-doctor to identify root causes and apply fixes.

Quick Start

Run the omc-doctor skill to diagnose and fix installation issues for oh-my-claudecode.

Frequently Asked Questions about omc-doctor

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I diagnose oh-my-claudecode installation issues in Claude Code?

To diagnose oh-my-claudecode installation issues, run the omc-doctor skill which analyzes plugin version gaps, settings.json hooks, legacy scripts, CLAUDE.md, and plugin cache to identify root causes and apply safe fixes.

Why does my oh-my-claudecode plugin show version gaps or misconfigurations?

Version gaps and misconfigurations in the oh-my-claudecode plugin often stem from legacy hooks or cache issues in local ~/.claude settings, which automated diagnostics can detect and remediate with safe rollback steps.

How do I fix legacy hooks and cache misconfigurations in ~/.claude settings?

Fix legacy hooks and cache misconfigurations in ~/.claude settings by running guided remediation that analyzes plugin version integrity, identifies duplicate or outdated scripts, and applies safe rollback steps to restore a healthy environment.

Can I safely rollback oh-my-claudecode plugin updates if Claude Code reports duplicates?

Yes, when Claude Code reports plugin misconfiguration or duplicates, guided remediation provides safe rollback steps to restore a healthy oh-my-claudecode environment by resolving detected cache and legacy script conflicts.

What does an oh-my-claudecode diagnostic check analyze in CLAUDE.md and settings.json?

An oh-my-claudecode diagnostic check analyzes CLAUDE.md configuration, settings.json hooks, plugin version data, legacy scripts, and plugin cache to determine installation health and necessary remediation actions.