omc-doctor

Diagnose oh-my-claudecode installation issues and prescribe remediation steps.

Updated Mar 31, 2026
One-click install
npx skills add https://github.com/ClementATH/oh-my-claudecode --skill omc-doctor-clementath
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: omc-doctor
Source: https://github.com/ClementATH/oh-my-claudecode/tree/main/skills/omc-doctor
Command: npx skills add https://github.com/ClementATH/oh-my-claudecode --skill omc-doctor-clementath

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Diagnose and fix oh-my-claudecode installation issues across local CLAUDE setups, ensuring plugins are current and environments are clean.

Core Features & Use Cases

  • Step-by-step health checks for plugin version, legacy hooks, legacy bash scripts, CLAUDE.md validation, plugin cache, and legacy curl-installed content.
  • Guidance to fix: remove legacy hooks, clean caches, verify CLAUDE.md, prune old cached versions, and remove legacy content.
  • Use Case: Admin of an oh-my-claudecode install encountering issues can run the Doctor to auto-diagnose and apply safe repairs.

Quick Start

Run the Doctor to scan your oh-my-claudecode installation and apply recommended repairs.

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 plugin version mismatches and legacy hook issues?

Diagnose oh-my-claudecode plugin version mismatches and legacy hook issues by running the Doctor workflow, which scans local CLAUDE environments, reports findings, and prescribes exact remediation steps like removing legacy hooks.

Why does my CLAUDE.md configuration break after updating oh-my-claudecode?

CLAUDE.md configuration breaks after updates due to legacy bash scripts or stale plugin caches; the Doctor validates CLAUDE.md settings, identifies conflicts, and guides you through cleaning up legacy content.

How to clean up stale plugin caches and old curl-installed content in CLAUDE?

Clean up stale plugin caches and old curl-installed content in CLAUDE by running the Doctor diagnostic workflow, which detects legacy artifacts and prescribes safe removal steps to ensure plugins are current.

Can I use the Doctor to troubleshoot oh-my-claudecode installations without dependencies?

Yes, you can use the Doctor to troubleshoot oh-my-claudecode installations without dependencies; it operates as a standalone diagnostic workflow covering plugin health, legacy cleanup, and CLAUDE.md validation.

What's the best way to fix legacy bash scripts and old curl-installed content in oh-my-claudecode?

The best way to fix legacy bash scripts and old curl-installed content is the Doctor diagnostic workflow, which detects outdated artifacts and prescribes exact remediation steps for a clean environment.

oh-my-claudecode plugin health check not working, what are the limitations?

If the oh-my-claudecode plugin health check is not working, limitations may include legacy hooks or stale caches; the Doctor identifies these issues and prescribes exact remediation steps to restore plugin health.