doctor

Diagnose oh-my-codex installation issues across plugin versions, hooks, and legacy content.

1|Updated Sep 22, 2025

Search Tags:#troubleshooting #hooks #codex #plugins #legacy #diagnose #oh-my-codex

Ready to run

npx skills add https://github.com/prthik/prathik-astro --skill doctor-prthik

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: doctor
Source: https://github.com/prthik/prathik-astro/tree/main/.codex/skills/doctor
Command: npx skills add https://github.com/prthik/prathik-astro --skill doctor-prthik

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Diagnose and fix oh-my-codex installation issues across plugin versions, hooks, and legacy content, reducing downtime and configuration drift.

Core Features & Use Cases

Plugin version checks: verify installed vs latest and highlight mismatches to ensure the plugin is up-to-date.
Hook configuration validation: detect stale or removed hook references that cause duplicates or broken workflows.
Legacy script and content hygiene: identify and report legacy bash hooks and old skill roots that conflict with canonical skills.
AGENTS.md integrity: confirm presence and proper OMX markers to ensure multi-agent configurations are valid.
Cache and migration hygiene: check plugin cache and legacy directories to advise cleanup or migration steps.

Quick Start

Run the OMX Doctor to perform the installation diagnostics and surface any issues.

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 plugin version mismatches and hook configuration errors?▼

To diagnose oh-my-codex installation issues, run the OMX Doctor to verify installed plugin versions against the latest releases and detect stale hook configurations. This diagnostic check automatically surfaces version mismatches and broken workflow references.

What causes legacy bash scripts and old skill roots to conflict with my codex plugins?▼

Legacy bash scripts and old skill roots conflict with canonical codex skills when outdated curl-installed content remains active. Identifying and removing these legacy artifacts ensures your installation aligns with the current canonical skill structure.

How do I check AGENTS.md presence and validate OMX markers for multi-agent configurations?▼

Checking AGENTS.md presence involves scanning for proper OMX markers to ensure multi-agent configurations are valid. The diagnostic process confirms file integrity and highlights missing or incorrect markers that destabilize your setup.

Does oh-my-codex doctor detect stale hooks and recommend cache cleanup steps?▼

Yes, oh-my-codex doctor detects stale or removed hook references and checks plugin cache for hygiene issues. It advises cache resets and recommends automated restoration of canonical skill roots when conflicts are found.

What is the best way to fix configuration drift and restore canonical skill roots in codex?▼

The best way to fix configuration drift is to run diagnostics that identify legacy directories and recommend automated restoration of canonical skill roots. This process removes legacy artifacts and resets caches to stabilize the environment.

Why does my codex installation have broken workflows after updating plugins?▼

Broken workflows after updating codex plugins often stem from stale hook configurations or legacy content conflicting with new versions. Running installation diagnostics identifies these removed hook references and recommends appropriate cleanup steps.