doctor

Diagnose and repair oh-my-codex installation issues with safety checks.

1|Updated Mar 15, 2026
One-click install
npx skills add https://github.com/Linnanli/xClaw --skill doctor-linnanli
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: doctor
Source: https://github.com/Linnanli/xClaw/tree/main/.codex/skills/doctor
Command: npx skills add https://github.com/Linnanli/xClaw --skill doctor-linnanli

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Diagnoses and fixes oh-my-codex installation issues to restore local tooling reliability and reduce downtime.

Core Features & Use Cases

  • Diagnostics & remediation for common plugin, configuration, and cache problems that prevent Codex from starting.
  • Guided checks for plugin versions, hook configurations, legacy scripts, and documentation status to avoid duplicates and failures.
  • Use Case: After a failed Codex startup, run this skill to identify misconfigurations and generate actionable fixes.

Quick Start

Run the installation diagnostics workflow to detect and resolve common oh-my-codex 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 installation issues?

To diagnose oh-my-codex installation issues, run a guided workflow that checks plugin versions, hook configurations, legacy scripts, AGENTS.md, and cache status to identify misconfigurations and generate fixes.

Why does Codex fail to start after installation?

Codex fails to start due to common plugin, configuration, and cache problems. Running an installation diagnostics workflow detects these misconfigurations and applies safety checks to resolve them and restore local tooling reliability.

What do I need to troubleshoot Codex plugin problems on my local machine?

Troubleshooting Codex plugin problems requires access to your local ~/.codex directory and npm tools to validate plugin versions, hook configurations, and cache status across your workstation environments.

Can I use a diagnostic skill to fix legacy scripts in Codex?

Yes, you can use a diagnostic skill to fix legacy scripts in Codex. It applies guided checks to detect outdated legacy scripts, validates changes with safety checks, and generates actionable fixes to prevent failures.

What is the best way to repair Codex hook configurations?

The best way to repair Codex hook configurations is to run an automated diagnostics workflow that targets hook setups, validates changes with safety checks, and restores local tooling reliability to reduce downtime.