skills.rest
Leap0920
Leap0920COMMUNITY
Explore all skills by this author →
WebsiteGitHub

omc-doctor

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

1|Updated Mar 30, 2026
Search Tags:#oh-my-claudecode#configuration validation#installation diagnostics#plugin cache#legacy hooks#clade code
One-click install
npx skills add https://github.com/Leap0920/Clean-Portfolio --skill omc-doctor-leap0920
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: omc-doctor
Source: https://github.com/Leap0920/Clean-Portfolio/tree/main/%25USERPROFILE%25/.openclaude/plugins/cache/omc/oh-my-claudecode/4.14.0/skills/omc-doctor
Command: npx skills add https://github.com/Leap0920/Clean-Portfolio --skill omc-doctor-leap0920

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps diagnose and resolve installation problems for oh-my-claudecode (OMC) inside Claude Code by checking version drift, legacy configuration, and missing required setup files.

Core Features & Use Cases

  • Plugin version and cache health checks: Detects whether the installed OMC plugin is missing, outdated, or whether multiple cached versions are causing confusion.
  • Legacy hooks and hook scripts detection: Flags older settings.json hook configurations and legacy bash hook scripts that can cause duplicate behavior.
  • CLAUDE.md/OMC marker verification: Verifies that CLAUDE.md (and any companion deterministic files) includes the canonical OMC markers and checks for version alignment with the cached plugin.
  • Ralph dependency check: Confirms Ruby is installed so Ralph workflows don’t fail later.
  • Optional remediation guidance: Provides safe, targeted commands to remove legacy components, clear stale cache, and re-fetch missing OMC configuration.

Quick Start

Run the omc-doctor skill to generate a step-by-step diagnosis report of your OMC installation and configuration.

Frequently Asked Questions about omc-doctor

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

FAQPage Schema
How do I fix oh-my-claudecode installation issues like missing configuration or broken hooks?▼

Legacy hooks cause duplicate behavior when older settings.json configurations and bash hook scripts remain active alongside new oh-my-claudecode installations. Detecting these legacy components involves scanning local filesystem paths under CLAUDE_CONFIG_DIR or ~/.claude to identify and safely remove outdated scripts that trigger redundant actions.

Why does Claude Code show duplicate behaviors from legacy hook scripts?▼

Legacy hooks cause duplicate behavior when older settings.json configurations and bash hook scripts remain active alongside new oh-my-claudecode installations. Detecting these legacy components involves scanning local filesystem paths under CLAUDE_CONFIG_DIR or ~/.claude to identify and safely remove outdated scripts that trigger redundant actions.

How do I check for oh-my-claudecode plugin version drift and stale cache?▼

Ruby is required for oh-my-claudecode to ensure Ralph workflows do not fail during execution. The installation diagnostics include a specific dependency check to confirm Ruby is installed on your system, preventing workflow errors before you begin using OMC features in Claude Code.

Do I need Ruby installed to use oh-my-claudecode features like Ralph workflows?▼

Ruby is required for oh-my-claudecode to ensure Ralph workflows do not fail during execution. The installation diagnostics include a specific dependency check to confirm Ruby is installed on your system, preventing workflow errors before you begin using OMC features in Claude Code.

What is the best way to diagnose a broken Claude Code OMC setup?▼

If your oh-my-claudecode configuration is missing required setup files, you should verify that CLAUDE.md includes canonical OMC markers and check for version alignment with the cached plugin. The diagnostic process provides safe, targeted commands to re-fetch missing OMC configuration and restore proper initialization.

What should I do if oh-my-claudecode configuration is missing required setup files?▼

If your oh-my-claudecode configuration is missing required setup files, you should verify that CLAUDE.md includes canonical OMC markers and check for version alignment with the cached plugin. The diagnostic process provides safe, targeted commands to re-fetch missing OMC configuration and restore proper initialization.

Related Skills

Explore More Software Engineering Skills→
nichobbsnichobbs

omc-doctor

Diagnose oh-my-claudecode installation issues by validating plugin versions and config remnants.

Community
Intermediate
eszxcvfdeszxcvfd

doctor

Diagnose oh-my-codex installation issues and generate remediation reports.

Community
Advanced
xdkpxdkp

omc-doctor

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

Community
Intermediate
sscciossccio

doctor

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

Community
Intermediate