doctor

Diagnose and fix OMX oh-my-codex installation issues in Codex CLI environments.

1|Updated Mar 17, 2025
One-click install
npx skills add https://github.com/ozby/node-pubsub --skill doctor-ozby
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: doctor
Source: https://github.com/ozby/node-pubsub/tree/main/.codex/skills/doctor
Command: npx skills add https://github.com/ozby/node-pubsub --skill doctor-ozby

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Diagnose and fix installation issues across the oh-my-codex ecosystem, ensuring Codex CLI environments run with correct skill roots, plugins, and configurations.

Core Features & Use Cases

  • Health checks for plugin versions, hook configurations, and legacy artifacts.
  • Automated diagnostics to surface misconfigurations such as outdated caches, legacy scripts, and incorrect skill paths.
  • Guided remediation steps with suggested fixes and safe recovery actions for common install problems.

Quick Start

Run the doctor skill to diagnose and repair OMX installation issues in your Codex CLI setup.

Frequently Asked Questions about doctor

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

FAQPage Schema
How do I diagnose oh-my-codex installation issues in Codex CLI?

Diagnose oh-my-codex installation issues in Codex CLI by running automated health checks that inspect plugin versions, hook configurations, and legacy artifacts to surface misconfigurations. The process identifies incorrect skill paths, outdated caches, and legacy scripts affecting your setup.

Why does my OMX plugin configuration show stale caches or legacy hooks?

OMX plugin configurations show stale caches or legacy hooks due to outdated plugin versions and legacy script artifacts left from previous installations. The diagnostic process detects these legacy artifacts and incorrect skill paths, offering guided remediation steps to clear caches and update configurations.

What is the best way to fix incorrect OMX skill root misconfigurations?

Fix incorrect OMX skill root misconfigurations by applying automated diagnostics that check plugin versions, validate AGENTS.md, and inspect legacy skill roots. The process provides auto-fix options and safe recovery actions to correct skill paths and restore proper Codex CLI environments.

Can I use the doctor skill to repair outdated plugins in oh-my-codex?

Yes, you can repair outdated plugins in oh-my-codex by running the doctor skill, which performs health checks on plugin versions and hook configurations. It identifies outdated caches and legacy scripts, then provides guided remediation steps with auto-fix options for safe recovery.

Does the doctor skill work with Codex CLI environments using legacy scripts?

Yes, the doctor skill works with Codex CLI environments containing legacy scripts by implementing checks for legacy artifacts, hook configurations, and AGENTS.md. It surfaces legacy scripts and stale caches, providing suggested fixes and safe recovery actions tailored to your installation context.

oh-my-codex installation not working after plugin update, what should I check?

When oh-my-codex installation is not working after a plugin update, check for plugin cache issues, hook configuration mismatches, and legacy skill roots. The diagnostic process inspects AGENTS.md and plugin versions to identify outdated caches and provides auto-fix remediation steps to resolve conflicts.