omc-doctor

Diagnose and resolve oh-my-claudecode installation issues.

Updated May 31, 2026
One-click install
npx skills add https://github.com/Ewallyw/claude-config-public --skill omc-doctor-ewallyw
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: omc-doctor
Source: https://github.com/Ewallyw/claude-config-public/tree/main/claude-config-master/claude-config-master/skills/omc-doctor
Command: npx skills add https://github.com/Ewallyw/claude-config-public --skill omc-doctor-ewallyw

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

The omc-doctor Skill unit addresses common installation issues with oh-my-claudecode, ensuring a smooth setup and usage experience.

Core Features & Use Cases

  • Version Checking: Identifies installed and latest plugin versions, alerting to outdated installations.
  • Legacy Hook Detection: Checks for legacy hooks in settings.json that could cause duplicates.
  • Legacy Script Identification: Scans for legacy bash hook scripts that may lead to confusion.
  • CLAUDE.md Validation: Ensures the presence and correctness of the CLAUDE.md configuration file.
  • Ralph Ruby Dependency Check: Validates the presence of Ruby, essential for Ralph workflows.
  • Plugin Cache Management: Monitors and manages plugin cache versions.
  • Legacy Content Removal: Identifies and removes legacy agents, commands, and skills directories.

Quick Start

Run the omc-doctor skill to automatically diagnose and fix common 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 and configuration errors?

To diagnose oh-my-claudecode installation issues, run a diagnostic check that identifies outdated plugin versions, legacy hooks, and missing CLAUDE.md configurations to automatically resolve setup conflicts.

Why does my oh-my-claudecode setup have duplicate hooks in settings.json?

Duplicate hooks in settings.json occur from legacy hook configurations left by previous oh-my-claudecode versions; detecting and removing these legacy entries resolves the duplication and prevents script conflicts.

Do I need Ruby installed to run Ralph workflows with oh-my-claudecode?

Yes, you need Ruby installed to run Ralph workflows; validating the Ruby dependency is required for oh-my-claudecode setup, ensuring the essential Ruby environment is present before execution.

What is the best way to clean up legacy oh-my-claudecode agents and scripts?

The best way to clean up legacy oh-my-claudecode content is to scan for and remove outdated agents, commands, skills directories, and legacy bash hook scripts that cause confusion during configuration.

How do I validate CLAUDE.md configuration for oh-my-claudecode?

Validating the CLAUDE.md configuration involves checking for the file's presence and correctness to ensure your oh-my-claudecode installation is properly configured and functioning without setup errors.

Can I manage plugin cache versions to fix oh-my-claudecode setup problems?

Yes, you can manage plugin cache versions to fix oh-my-claudecode setup problems by monitoring and clearing outdated cached plugins that cause installation issues and version conflicts.