Can it fix issues automatically?

Yes, after providing a diagnostic report, the skill offers an auto-fix mode that removes legacy scripts, updates configurations, and clears stale caches once you provide confirmation.

Does it work with custom directory paths?

Yes, the OMX Doctor respects the CODEX_HOME environment variable for all path-based diagnostics and repairs, ensuring compatibility with custom setups.

When should I run the Doctor skill?

It is recommended to run the Doctor skill after updating oh-my-codex, when migrating from manual installations, or whenever you experience issues with agent hooks or commands.

What does the OMX Doctor skill actually do?

It scans your oh-my-codex installation for version mismatches, legacy configuration files, and stale caches to ensure your AI coding environment is healthy and performing optimally.

OMX Installation Doctor

Name: OMX Installation Doctor
Author: Yeachan-Heo

byYeachan-Heo

•

2,007

•

開発者ツール

Diagnoses and automatically repairs installation issues, configuration conflicts, and legacy artifacts within the oh-my-codex environment.

The OMX Doctor skill is a comprehensive diagnostic utility designed to maintain the health of your oh-my-codex (OmX) installation. It systematically audits plugin versions, identifies conflicting legacy hook configurations in config.toml or settings.json, and detects stale cache files or outdated bash scripts. By providing detailed health reports and automated fix options, it ensures that your Claude Code environment remains optimized and free from the errors common in evolving plugin ecosystems, making it essential for users moving from legacy curl-based setups to the modern plugin system.

主な機能

01One-click auto-fix capabilities for common installation errors

02Automated version comparison against the npm registry

03Validation of AGENTS.md configuration and multi-agent markers

042,007 GitHub stars

05Stale plugin cache identification and optimization

06Detection and cleanup of legacy bash hook scripts

ユースケース

01Verifying that the Multi-Agent System and AGENTS.md are correctly configured and active

02Migrating and cleaning up legacy files from older curl-based oh-my-codex installations

03Troubleshooting performance issues or unexpected behavior in Claude Code after a plugin update

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add yeachan-heo/oh-my-codex doctor

For use in Claude.ai and ChatGPT

Download Skill