skills.rest
xdkp
xdkpCOMMUNITY
Explore all skills by this author →
GitHub

omc-doctor

Diagnose oh-my-claudecode installation issues and report CRITICAL, WARN, or OK outcomes.

Updated May 20, 2026
Search Tags:#claude code#configuration validation#omc-doctor#installation diagnostics#legacy hooks#plugin versioning#cache cleanup
One-click install
npx skills add https://github.com/xdkp/oh-my-claudecode --skill omc-doctor-xdkp
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: omc-doctor
Source: https://github.com/xdkp/oh-my-claudecode/tree/main/skills/omc-doctor
Command: npx skills add https://github.com/xdkp/oh-my-claudecode --skill omc-doctor-xdkp

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you identify why oh-my-claudecode (OMC) isn’t working correctly by checking plugin versions, configuration markers, legacy hooks, and stale caches that commonly break installs.

Core Features & Use Cases

  • Plugin health checks: Compares installed vs latest plugin versions and detects stale multiple-version caches.
  • Configuration validation: Verifies required CLAUDE.md setup, including the OMC start marker and version alignment with the cached plugin.
  • Legacy conflict detection: Flags legacy settings.json hooks, legacy hook scripts, and old curl-installed agents/commands/skills that can conflict with the plugin system.

Quick Start

Run the omc-doctor skill to generate an installation report and recommended fixes for your current Claude Code/OMC setup.

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 caused by stale caches or legacy hooks?▼

Diagnose oh-my-claudecode installation issues by running the omc-doctor skill to check plugin versions, validate CLAUDE.md markers, and detect legacy hooks. It produces actionable CRITICAL, WARN, or OK outcomes for your setup.

Why does my Claude Code setup show duplicate behavior or missing skills after updating?▼

Duplicate behavior or missing skills in Claude Code occur when stale multiple-version caches or legacy settings.json hooks conflict with the plugin system. The omc-doctor skill detects these conflicts and recommends specific fixes.

What is the best way to validate CLAUDE.md configuration markers for OMC plugins?▼

The best way to validate CLAUDE.md configuration markers is using the omc-doctor skill, which checks for the OMC start marker and verifies version alignment with the cached plugin to ensure correct configuration.

Can I use omc-doctor to check both marketplace and npm installed OMC plugins?▼

Yes, you can use omc-doctor to check OMC plugins installed via both marketplace and npm. It compares installed versus latest plugin versions and detects stale multiple-version caches across different installation methods.

How do I fix outdated oh-my-claudecode setups when old curl-installed agents conflict with the plugin system?▼

To fix outdated oh-my-claudecode setups with conflicting curl-installed agents, run the omc-doctor skill to flag old agents, commands, and skills. It generates an installation report with recommended fixes to resolve legacy conflicts.

Related Skills

Explore More Software Engineering Skills→
Leap0920Leap0920
1

omc-doctor

Diagnose oh-my-claudecode installation issues by checking plugin cache versions and legacy hooks.

Community
Advanced
ClementATHClementATH

omc-doctor

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

Community
Advanced
redsub-captainredsub-captain
2

redsub-setup

Automate Claude Code plugin setup, permissions, and CLAUDE.md file management.

Community
Intermediate
ChegginCheggin
1

omc-doctor

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

Community
Advanced