doctor

Diagnose oh-my-codex installation issues across plugin versions, hooks, and cache states.

Updated Jul 3, 2025
One-click install
npx skills add https://github.com/andrew-t-james/dotfiles --skill doctor-andrew-t-james
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: doctor
Source: https://github.com/andrew-t-james/dotfiles/tree/main/dot_codex/skills/doctor
Command: npx skills add https://github.com/andrew-t-james/dotfiles --skill doctor-andrew-t-james

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Diagnose and fix oh-my-codex installation issues by providing a structured, repeatable diagnostic workflow.

Core Features & Use Cases

  • Checks plugin version, hook configuration, legacy scripts, AGENTS.md, and cache states to surface misconfigurations.
  • Detects legacy curl-installed content and stale skill roots to guide cleanup.
  • Produces a formatted report and actionable remediation steps.

Quick Start

Run the doctor skill to diagnose and fix oh-my-codex installation 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 across local environments?

To diagnose oh-my-codex installation issues, run a structured diagnostic workflow that checks plugin versions, hook configurations, legacy scripts, AGENTS.md, and cache states to surface misconfigurations and propose fixes.

What causes oh-my-codex plugin misconfigurations and stale cache states?

Oh-my-codex plugin misconfigurations and stale cache states often stem from legacy curl-installed content or outdated skill roots, which systematic diagnostic checks can detect and guide you to clean up.

Do I need Codex configuration access to troubleshoot oh-my-codex hook configuration problems?

Yes, troubleshooting oh-my-codex hook configuration problems requires access to your Codex configuration, plugin cache, and shell utilities to perform systematic checks and propose remediation steps.

How do I detect and clean up legacy curl-installed content for oh-my-codex?

Detect and clean up legacy curl-installed content by running a diagnostic workflow that identifies stale skill roots and legacy scripts, then follow the generated report's actionable remediation steps.

oh-my-codex installation not working, how do I generate a diagnostic report?

When your oh-my-codex installation is not working, running the doctor skill generates a formatted diagnostic report that identifies misconfigurations across your plugin versions and cache states.