omc-doctor

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

16|3|Updated Mar 12, 2026
One-click install
npx skills add https://github.com/sehoon787/my-claude --skill omc-doctor-sehoon787
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: omc-doctor
Source: https://github.com/sehoon787/my-claude/tree/main/skills/omc/omc-doctor
Command: npx skills add https://github.com/sehoon787/my-claude --skill omc-doctor-sehoon787

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Diagnose and fix oh-my-claudecode installation issues that block Claude Code sessions, ensuring a smooth startup and consistent behavior.

Core Features & Use Cases

  • Comprehensive diagnostics across plugin version, legacy hooks, and old scripts, plus CLAUDE.md checks and plugin cache validation to surface actionable remediation.
  • Use cases include quick health checks after upgrades, cleaning legacy leftovers, and restoring proper plugin configuration to minimize downtime.

Quick Start

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

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 on Claude Code?

Diagnose oh-my-claudecode installation issues by running the omc-doctor skill, which checks plugin versions, legacy hooks, old scripts, CLAUDE.md configurations, and plugin cache validation to surface actionable remediation steps.

Why does my Claude Code session fail to start after a plugin upgrade?

Claude Code startup failures after upgrades often stem from legacy hooks or old scripts left behind. Run omc-doctor to detect and clean these leftovers, restoring proper plugin configuration and ensuring consistent session behavior.

Can I check my CLAUDE_CONFIG_DIR environment for plugin misconfigurations?

Yes, omc-doctor applies across local user environments where CLAUDE_CONFIG_DIR is used, validating plugin cache and checking for misconfigurations to provide clear severity guidance and automated or guided fixes.

What's the best way to clean up legacy hooks from old oh-my-claudecode installs?

The best way to clean legacy leftovers is running omc-doctor, which systematically detects old scripts and legacy hooks, then offers automated or guided fixes to minimize downtime and restore proper plugin configuration.

How do I validate my plugin cache when oh-my-claudecode is not working?

Plugin cache validation is built into omc-doctor diagnostics. Running the skill checks your plugin cache alongside version and hook integrity, surfacing clear remediation steps to resolve cache-related installation issues.

Does omc-doctor require any dependencies to run diagnostics?

No, omc-doctor has no external dependencies. It runs directly within your Claude Code environment to perform comprehensive diagnostics, ensuring reproducible results and clear severity guidance without requiring additional packages.