skills.rest
prthik
prthikCOMMUNITY
Explore all skills by this author →
GitHub

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
One-click install
npx skills add https://github.com/prthik/prathik-astro --skill doctor-prthik
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
SOELexiconSOELexicon

clickup-setup-guide

Automate ClickUp Framework CLI installation and configuration across Linux, macOS, and Windows.

Community
Intermediate
OrinksOrinks
24

doctor

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

Community
Advanced
BetaSBetaS

doctor

Diagnose and resolve oh-my-codex installation and configuration issues.

Community
Advanced
riethmayerriethmayer
2

doctor

Diagnose and fix oh-my-codex installation issues across Codex environments.

Community
Advanced