doctor

Diagnose oh-my-codex installation issues and recommend remediation steps.

Updated Feb 21, 2026
One-click install
npx skills add https://github.com/byonk19-svg/rt-scheduler --skill doctor-byonk19-svg
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: doctor
Source: https://github.com/byonk19-svg/rt-scheduler/tree/main/.codex/skills/doctor
Command: npx skills add https://github.com/byonk19-svg/rt-scheduler --skill doctor-byonk19-svg

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Diagnose and fix oh-my-codex installation issues by guiding a user through common root causes and remediation steps.

Core Features & Use Cases

  • Installation health checks: verify plugin version, hook configurations, legacy scripts, AGENTS.md, and cache state.
  • Remediation guidance: provide concrete steps to clean up legacy hooks, clear caches, and reinstall components.
  • Troubleshooting workflow: supports common failure modes in codex toolchain and guides user to safe recovery.

Quick Start

Run the doctor skill to diagnose and fix oh-my-codex installation issues on your machine.

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?

Diagnose oh-my-codex installation issues by running a health check that verifies plugin versions, hook configurations, AGENTS.md files, and cache states to identify root causes for remediation

Why does my Codex CLI plugin fail to load after updating?

Codex CLI plugin loading failures often stem from legacy hook conflicts or corrupted plugin caching. Running diagnostic checks identifies stale legacy scripts and verifies hook sanity to recommend the correct cleanup procedure.

What is the best way to clean up legacy hooks in a Codex toolchain?

Clean up legacy hooks in a Codex toolchain by following guided remediation steps that remove outdated scripts, clear corrupted caches, and reinstall components to restore a safe and functional CLI environment.

Does the Codex doctor workflow support AGENTS.md configurations?

The Codex doctor workflow explicitly supports AGENTS.md configurations by validating their presence and state during installation health checks to ensure proper Codex CLI plugin integration and functionality.

How do I fix plugin caching errors when using Codex CLI?

Fix plugin caching errors in Codex CLI by executing cache management steps provided by the diagnostic workflow, which clears invalid cache states and reinstalls components to resolve common failure modes.