skills.rest
KYRIE66nb
KYRIE66nbCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

doctor

Diagnose and fix oh-my-codex misconfigurations in Codex CLI environments.

Updated Apr 8, 2026
Search Tags:#troubleshooting#cli#debug#config#installation#diagnose#oh-my-codex
One-click install
npx skills add https://github.com/KYRIE66nb/codex-omx-public-config --skill doctor-kyrie66nb
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: doctor
Source: https://github.com/KYRIE66nb/codex-omx-public-config/tree/main/home/.agents/skills/doctor
Command: npx skills add https://github.com/KYRIE66nb/codex-omx-public-config --skill doctor-kyrie66nb

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Diagnoses and fixes oh-my-codex installation issues to restore a healthy Codex CLI environment.

Core Features & Use Cases

  • Checks plugin version consistency and cache integrity.
  • Validates hook configurations and legacy scripts to prevent duplicates and conflicts.
  • Detects and reports legacy curl-installed content and missing/outdated AGENTS.md, with remediation steps.

Quick Start

Run the OMX Doctor to diagnose and repair your Codex installation.

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 a broken Codex CLI installation?▼

To diagnose a broken Codex CLI installation, inspect the plugin version consistency, validate hook configurations, and check for legacy curl-installed content under ~/.codex to identify misconfigurations and apply suggested remediation steps.

What causes duplicate hook conflicts in oh-my-codex?▼

Duplicate hook conflicts in oh-my-codex are caused by legacy hook scripts and outdated configurations. Validating hook configurations and removing legacy curl-installed content prevents these duplicates and restores a healthy environment.

How do I check if AGENTS.md is missing or outdated in my Codex environment?▼

Checking for a missing or outdated AGENTS.md involves inspecting the ~/.codex directory for the file's existence and version state, detecting legacy content, and returning structured findings with remediation steps to restore it.

Does the Codex CLI troubleshooter work without additional dependencies?▼

The Codex CLI troubleshooter works without additional dependencies, requiring only an existing Codex installation under ~/.codex to inspect plugin state, config files, legacy scripts, and AGENTS.md presence for structured findings.

Why is my oh-my-codex plugin failing after a manual update?▼

Your oh-my-codex plugin may be failing after a manual update due to plugin version inconsistency or cache integrity issues. Checking plugin version consistency and validating legacy scripts will isolate the misconfiguration.

What is the best way to clean up legacy curl-installed Codex scripts?▼

The best way to clean up legacy curl-installed Codex scripts is to detect and report the legacy content across typical user setups, then apply the suggested remediation steps to remove conflicts and restore a healthy CLI environment.

Related Skills

Explore More Software Engineering Skills→
riethmayerriethmayer
2

doctor

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

Community
Advanced
wmasfoewmasfoe

doctor

Diagnose OMX installation issues and restore a healthy Codex environment.

Community
Advanced
byonk19-svgbyonk19-svg

doctor

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

Community
Intermediate
gtpgg1013gtpgg1013

doctor

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

Community
Advanced