omc-doctor

Diagnose and fix oh-my-claudecode installation and configuration issues.

Updated Aug 23, 2026

Search Tags:#developer tools #debugging #troubleshooting #configuration #installation #omc

Ready to run

npx skills add https://github.com/mrsono0/lectures --skill omc-doctor

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: omc-doctor
Source: https://github.com/mrsono0/lectures/tree/main/.claude/skills/omc-doctor
Command: npx skills add https://github.com/mrsono0/lectures --skill omc-doctor

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill diagnoses and resolves common installation and configuration problems with the oh-my-claudecode (OMC) tool, ensuring a smooth user experience.

Core Features & Use Cases

Installation Diagnostics: Checks for outdated plugins, legacy configurations, and missing essential files.
Automated Fixing: Offers to automatically resolve detected issues, such as removing legacy hooks or clearing plugin caches.
Use Case: If your OMC tool is not behaving as expected, run the Doctor skill to pinpoint the exact cause and get it fixed with a single command.

Quick Start

Run the omc-doctor skill to diagnose and fix any oh-my-claudecode installation problems.

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 and configuration issues?▼

To diagnose oh-my-claudecode installation issues, run the omc-doctor skill to scan for outdated plugins, legacy hooks in settings.json, stale bash scripts in ~/.claude/hooks, and missing CLAUDE.md files. It generates a comprehensive system health report pinpointing exact configuration errors.

What are common causes of oh-my-claudecode not behaving as expected?▼

Common causes of oh-my-claudecode malfunctions include outdated plugins, legacy curl-installed content in agents and commands directories, multiple cached plugin versions, and stale bash scripts in ~/.claude/hooks. Diagnosing tools scan these directories to identify and resolve the exact conflicts.

Can I automatically fix legacy hooks and stale plugin caches in oh-my-claudecode?▼

Yes, you can automatically fix legacy hooks and stale plugin caches by running a diagnostic tool that offers automated resolution for detected issues. This includes removing legacy hooks from settings.json and clearing multiple cached plugin versions from your system directories.

Does oh-my-claudecode troubleshooting require any external dependencies?▼

No, oh-my-claudecode troubleshooting does not require external dependencies. The diagnostic skill operates independently using internal scripts and references to scan local directories, detect missing CLAUDE.md files, and resolve configuration issues without needing additional packages.

Why does my oh-my-claudecode setup have legacy curl-installed content?▼

Legacy curl-installed content remains in oh-my-claudecode setups when older installation methods leave files in agents, commands, and skills directories. Diagnostic tools detect these outdated files and provide automated fixes to remove them and restore proper system health.