doctor

Diagnose OMX installation issues and restore a healthy Codex environment.

Updated Apr 23, 2026
One-click install
npx skills add https://github.com/wmasfoe/notch-pet --skill doctor-wmasfoe
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: doctor
Source: https://github.com/wmasfoe/notch-pet/tree/main/.codex/skills/doctor
Command: npx skills add https://github.com/wmasfoe/notch-pet --skill doctor-wmasfoe

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps developers and operators quickly identify and fix issues that prevent OMX installations from running smoothly. It pinpoints misconfigurations, outdated plugins, and legacy setup artifacts that block Codex from loading and operating correctly.

Core Features & Use Cases

  • Installation diagnostics: checks plugin version, hook configuration, legacy scripts, AGENTS.md, and cache to surface issues.
  • Root-cause analysis: detects outdated or conflicting components across canonical and legacy skill roots.
  • Remediation guidance: provides actionable steps to repair configuration and restore a healthy Codex environment.

Quick Start

Run the doctor skill to diagnose and fix OMX installation issues on your machine.

Frequently Asked Questions about doctor

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

FAQPage Schema
How do I diagnose OMX installation problems on macOS?

To diagnose OMX installation problems on macOS, run the doctor skill to check your plugin version, hook configuration, legacy scripts, AGENTS.md, and plugin cache for misconfigurations. It surfaces issues and provides structured remediation steps to restore your environment.

Why does Codex fail to load due to outdated hooks and legacy configurations?

Codex fails to load when outdated hooks and legacy configurations conflict with canonical skill roots. The doctor skill pinpoints these conflicting components and legacy setup artifacts, providing actionable steps to repair the configuration and restore a healthy Codex environment.

How do I fix duplicate AGENTS.md issues in my OMX setup?

Fix duplicate AGENTS.md issues in your OMX setup by running the doctor skill to detect outdated or conflicting AGENTS.md files across mixed skill roots. It provides root-cause analysis and structured remediation guidance to clean up duplicates and restore proper Codex loading.

Can I use this diagnostics tool to check my plugin cache and canonical skills directory?

Yes, you can use this diagnostics tool to check your plugin cache and canonical skills directory. The doctor skill explicitly inspects both locations alongside hook configuration and plugin version to ensure your OMX installation operates smoothly without conflicting components.

What is the best way to restore a healthy Codex environment after a misconfigured installation?

The best way to restore a healthy Codex environment is running the doctor skill for structured diagnostics and remediation. It detects root causes across legacy and canonical skill roots, then provides actionable steps to repair configuration and fix outdated plugins.