What does the OMC Doctor skill actually check?

It performs a multi-step diagnostic scan of plugin versions, legacy bash hooks in settings.json, outdated script files, CLAUDE.md formatting, and stale plugin caches.

Why do I need to restart Claude Code after a fix?

Claude Code loads its configuration and plugin state at startup. A restart ensures that the environment recognizes the cleaned cache and updated settings applied by the Doctor.

Is it safe to use the Auto-Fix feature?

Yes. The Auto-Fix feature targets specific legacy OMC files and known configuration errors. It includes safeguards to avoid deleting your custom agents or unique user scripts.

How does it handle CLAUDE.md issues?

It checks for required OMC markers and configuration patterns. If missing, it can automatically fetch and restore the latest canonical CLAUDE.md template from the official repository.

OMC Doctor

Name: OMC Doctor
Author: Moliboy5000

byMoliboy5000

0•

Developer Tools

Diagnoses and resolves oh-my-claudecode installation issues, legacy configuration conflicts, and plugin cache inconsistencies.

OMC Doctor is a specialized utility designed to maintain the health and stability of the oh-my-claudecode (OMC) environment. It performs a comprehensive suite of diagnostic checks, including version verification, identification of legacy bash hooks in settings, and scanning for outdated plugin caches. Beyond just reporting, the skill offers automated remediation paths to resolve configuration conflicts, clean up stale assets, and synchronize CLAUDE.md files, ensuring a seamless and optimized experience for Claude Code users utilizing the OMC framework.

Key Features

010 GitHub stars

02Plugin cache cleanup and version management

03One-click Auto-Fix for identified system issues

04Legacy hook and bash script conflict detection

05CLAUDE.md configuration validation and repair

06Automated installation health diagnostics

Use Cases

01Ensuring global and project-level CLAUDE.md files are correctly configured

02Troubleshooting unexpected behavior in oh-my-claudecode after a version update

03Cleaning up legacy manual installations when migrating to the OMC plugin system

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add moliboy5000/.claude omc-doctor

For use in Claude.ai and ChatGPT