doctor

Diagnose and fix oh-my-codex installation issues across macOS and Linux.

Updated Mar 21, 2026
One-click install
npx skills add https://github.com/gtpgg1013/claude-skills-collection --skill doctor-gtpgg1013
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: doctor
Source: https://github.com/gtpgg1013/claude-skills-collection/tree/main/skills/agents/doctor
Command: npx skills add https://github.com/gtpgg1013/claude-skills-collection --skill doctor-gtpgg1013

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Diagnoses and fixes oh-my-codex installation issues to ensure Codex runs smoothly and reliably.

Core Features & Use Cases

  • Comprehensive installation diagnostics including plugin version checks, hook configuration validation, detection of legacy scripts, and AGENTS.md presence.
  • Guided, actionable fixes and guardrails to prevent duplicate configurations and stale caches.
  • Use Case: When Codex reports plugin mis-match or misconfiguration, run the doctor to restore a healthy environment.

Quick Start

Run the OMX Doctor diagnostic to identify and repair oh-my-codex installation issues.

Frequently Asked Questions about doctor

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

FAQPage Schema
How do I diagnose and fix oh-my-codex installation issues on macOS and Linux?

To diagnose oh-my-codex installation issues, run the OMX Doctor diagnostic. It validates plugin cache, configuration files, legacy scripts, and install state, then guides automated or manual fixes across macOS and Linux environments.

What causes plugin version mismatches and misconfigured hooks in Codex?

Plugin version mismatches and misconfigured hooks in Codex often stem from stale caches, legacy curl installs, or missing AGENTS.md files. The diagnostic tool validates these configurations and applies guided fixes to restore a healthy environment.

Can I use the doctor diagnostic to detect legacy curl installs and missing AGENTS.md files?

Yes, the doctor diagnostic detects legacy curl installs and missing AGENTS.md files. It comprehensively validates your plugin cache, configuration files, and install state to ensure oh-my-codex runs smoothly and reliably.

What's the best way to troubleshoot oh-my-codex plugin misconfiguration errors?

The best way to troubleshoot oh-my-codex plugin misconfiguration is running the OMX Doctor. It identifies duplicate configurations, stale caches, and version mismatches, providing actionable guardrails and guided fixes for a healthy setup.

Why does my Codex report plugin mis-match after installation?

Codex reports plugin mis-match when installation issues like stale caches or misconfigured hooks exist. The doctor diagnostic validates plugin versions and install state, offering automated or manual guided fixes to resolve the mismatch.