skills.rest
hotaq
hotaqCOMMUNITY
Explore all skills by this author →
GitHub

doctor

Diagnose and repair Codex installation issues across plugin caches and configuration files.

Updated Apr 20, 2026
Search Tags:#troubleshooting#hooks#codex#cleanup#cache#diagnostics#installation
One-click install
npx skills add https://github.com/hotaq/Sprite_harmess --skill doctor-hotaq
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: doctor
Source: https://github.com/hotaq/Sprite_harmess/tree/main/.codex/skills/doctor
Command: npx skills add https://github.com/hotaq/Sprite_harmess --skill doctor-hotaq

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you diagnose and clean up broken Codex or oh-my-codex installations when startup issues, duplicate entries, stale caches, or legacy files prevent the environment from behaving correctly.

Core Features & Use Cases

  • Plugin and cache checks: Compares installed plugin versions against the latest release and spots stale marketplace caches.
  • Hook and config review: Finds legacy hook entries in config files that can cause duplicate or conflicting behavior.
  • Legacy file cleanup: Identifies old bash scripts, agent files, command files, and overlapping skill roots that should be removed or archived.
  • Use case: Use it when Codex reports confusing setup behavior and you want a clear report with recommended fixes before changing anything.

Quick Start

Ask the doctor skill to inspect my Codex installation, report any legacy hooks, stale caches, or duplicate skill roots, and tell me the safest fixes to apply.

Frequently Asked Questions about doctor

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fix Codex installation problems with stale caches and legacy hooks?▼

Codex installation problems caused by stale caches and legacy hooks are fixed by inspecting plugin caches, hook configuration files, and filesystem paths to identify and remove outdated entries. This diagnostic process generates a clear report of conflicting setup state and recommends the safest fixes to apply.

What causes duplicate or conflicting hook behavior in Codex setups?▼

Duplicate or conflicting hook behavior in Codex is caused by legacy hook entries left in configuration files and overlapping skill roots. Reviewing these configuration files identifies old bash scripts and agent files that should be removed or archived to resolve the conflict.

How do I clean up old oh-my-codex artifacts and duplicate skill entries?▼

Old oh-my-codex artifacts and duplicate skill entries are cleaned up by inspecting filesystem paths and versioned plugin caches to locate stale bash scripts and command files. Optional removal of these legacy entries refreshes the canonical skill root to restore correct environment behavior.

Does the Codex doctor check work for local development environments without changing files?▼

The Codex diagnostic check works for local development environments by inspecting configuration files and filesystem paths to report issues without changing anything. It compares installed plugin versions against the latest release and flags stale marketplace caches before you apply any fixes.

Why does my Codex setup report confusing behavior after a plugin update?▼

Confusing Codex setup behavior after a plugin update happens when outdated setup state, duplicate skill roots, or legacy AGENTS.md files conflict with new versions. Diagnosing the installation identifies which stale caches and overlapping artifacts prevent the environment from behaving correctly.

Related Skills

Explore More Software Engineering Skills→
realsigridjinrealsigridjin
20

doctor

Diagnose oh-my-codex installation and configuration issues with a health report.

Community
Advanced
Goblin1024Goblin1024
6

doctor

Diagnose and fix oh-my-kimi installation issues across local environments.

Community
Intermediate
vitalliumvitallium
10

ce-update

Compare installed compound-engineering plugin versions against upstream main in Claude Code.

Community
Advanced
gtpgg1013gtpgg1013

doctor

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

Community
Advanced