skills.rest
ogiboy
ogiboyCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

doctor

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

Updated Feb 1, 2024
Search Tags:#troubleshooting#configuration#diagnostics#codex cli#oh-my-codex#plugin cache#installation repair
One-click install
npx skills add https://github.com/ogiboy/portfolio-app --skill doctor-ogiboy
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: doctor
Source: https://github.com/ogiboy/portfolio-app/tree/main/.codex/skills/doctor
Command: npx skills add https://github.com/ogiboy/portfolio-app --skill doctor-ogiboy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? OMX installations can break or degrade over time due to outdated plugin caches, legacy hook scripts, missing AGENTS.md configuration, and leftover files from older install methods. This Skill runs a structured diagnostic to find these issues and optionally repairs them. ## Core Features & Use Cases - Six-Step Diagnostic: Checks plugin cache versions against npm, hook configuration in config.toml and legacy settings.json, legacy bash hook scripts, AGENTS.md presence and OMX marker, stale plugin caches, and legacy curl-installed agents/commands/skills. - Structured Health Report: Produces a summary table with OK/WARN/CRITICAL status per check plus a list of issues and recommended fixes. - Guided Auto-Fix: With user confirmation, removes legacy hooks and scripts, clears stale plugin caches, restores AGENTS.md from the official repository, and cleans up legacy install directories. - Use Case: After upgrading oh-my-codex, you see duplicate skills in the Codex Enable/Disable Skills UI. Run the doctor to detect the overlapping legacy ~/.agents/skills root and remove it safely. ## Quick Start Run the OMX doctor to diagnose my oh-my-codex installation and report any issues with plugin cache, hooks, and AGENTS.md.

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 problems?▼

Run the OMX doctor diagnostic, which checks plugin cache versions, hook configuration in config.toml and legacy settings.json, legacy bash scripts, AGENTS.md, and leftover install directories. It outputs a report with OK, WARN, or CRITICAL status per check plus recommended fixes.

How do I fix duplicate skills in the Codex Enable/Disable Skills UI?▼

Duplicates occur when both the canonical ~/.codex/skills root and the legacy ~/.agents/skills directory exist. Archive or remove ~/.agents/skills after confirming ~/.codex/skills is your active root, then restart Codex CLI.

Does the doctor respect the CODEX_HOME environment variable?▼

Yes, all ~/.codex paths in the diagnostic respect CODEX_HOME when it is set. The checks and fixes resolve paths as ${CODEX_HOME:-~/.codex} so custom home locations are handled correctly.

Why does the doctor warn about multiple plugin cache versions?▼

Multiple version directories under one marketplace's oh-my-codex cache indicate stale cached artifacts. The fix keeps only the newest version directory and removes the rest, then you restart Codex CLI to fetch a clean state.

Can the doctor fix issues automatically?▼

Yes, after the report it asks for confirmation before applying fixes. Fixes include removing legacy hooks and bash scripts, clearing stale plugin caches, restoring AGENTS.md from the official GitHub source, and removing legacy agents, commands, and skills directories.

Related Skills

Explore More Software Engineering Skills→
ozbyozby
1

doctor

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

Community
Advanced
OrinksOrinks
24

doctor

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

Community
Advanced
SongYunSeopSongYunSeop
1

update-plugin

Update the installed Oh My TIL plugin via git pull and npm run deploy.

Community
Advanced
1cFE1cFE
6

model-validation

Validate SysML models with a six-level blocking and non-blocking pyramid.

Official
Advanced