omc-doctor

Diagnose and fix oh-my-claudecode installation issues across local and CI environments.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Diagnose and fix oh-my-claudecode installation issues.

Core Features & Use Cases

  • Performs comprehensive checks to detect misconfigurations, outdated plugins, legacy hooks, and stale caches that prevent Claude from running correctly.
  • Guides you through remediation steps to restore a healthy OMC environment across local machines and CI.

Quick Start

Run the OMC Doctor to diagnose and fix oh-my-claudecode installation issues across your Claude environment.

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?

To diagnose oh-my-claudecode installation issues, run the OMC Doctor to validate plugin cache health, check CLAUDE.md configuration markers, detect legacy curl installs, and identify stale hooks across local environments and CI pipelines.

What causes oh-my-claudecode configuration drift?

Configuration drift happens when CLAUDE.md version markers and the plugin cache become out of sync. The OMC Doctor detects this mismatch by enforcing checks for CLAUDE.md existence and comparing its markers against the cached plugin state.

How do I fix legacy curl install content in Claude?

To fix legacy curl install content, the OMC Doctor flags outdated legacy configurations as actionable items and guides you through remediation steps to remove stale hooks and restore a healthy OMC environment.

Does the OMC Doctor work in CI environments?

Yes, the OMC Doctor works in CI environments. It performs comprehensive checks across local machines and CI pipelines to detect misconfigurations, outdated plugins, and stale caches that prevent Claude from running correctly.

Why is my oh-my-claudecode plugin cache not working correctly?

Your oh-my-claudecode plugin cache may not work correctly due to stale caches, configuration drift between CLAUDE.md markers and cache, or legacy hooks. The OMC Doctor validates cache health and guides remediation to restore functionality.

What is the best way to troubleshoot stale hooks in oh-my-claudecode?

The best way to troubleshoot stale hooks is running the OMC Doctor, which detects potential stale hooks across your environment, flags legacy content as actionable items, and provides guided remediation steps for a healthy OMC setup.