doctor

Diagnose and resolve OMX installation issues with Bash scripts.

Updated Jul 2, 2026
One-click install
npx skills add https://github.com/JaCha00/nais2-integration-complete --skill doctor-jacha00
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: doctor
Source: https://github.com/JaCha00/nais2-integration-complete/tree/main/.codex/skills/doctor
Command: npx skills add https://github.com/JaCha00/nais2-integration-complete --skill doctor-jacha00

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill unit provides diagnostic tools to identify and resolve common installation issues within OMX (Oh-My-Codex).

Core Features & Use Cases

  • Diagnostic Checks: Runs comprehensive checks on plugin versions, hook configurations, legacy scripts, AGENTS.md file, plugin cache, legacy content, and more.
  • Problem Identification: Flags outdated caches, legacy scripts, missing configurations, and other potential problems.
  • Automated Fixing: Offers automatic fixes for issues such as outdated plugin caches, legacy hook configurations, and other common problems. Requires user confirmation before applying fixes.

Quick Start

Run the doctor skill to diagnose and fix common installation issues in OMX.

Frequently Asked Questions about doctor

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

FAQPage Schema
How do I fix OMX installation issues like outdated plugin caches?

To fix OMX installation issues, you can run a diagnostic tool that identifies outdated plugin caches and applies automated fixes. It checks your plugin versions and hook configurations to resolve common setup problems efficiently.

What causes legacy script errors during OMX configuration?

Legacy script errors during OMX configuration are typically caused by outdated hook configurations or missing AGENTS.md files. Running a diagnostic check flags these legacy contents and outdated caches so they can be automatically resolved.

How do I diagnose missing AGENTS.md file problems in OMX?

You can diagnose missing AGENTS.md file problems in OMX by running comprehensive diagnostic checks. The tool scans your environment for missing configurations, flags potential issues, and offers automated fixes after user confirmation.

Does the OMX doctor script automatically resolve hook configuration issues?

Yes, the OMX doctor script automatically resolves hook configuration issues. It utilizes Bash scripting to detect outdated legacy hooks and applies the necessary fixes after requesting your explicit confirmation.

What is the best way to troubleshoot Oh-My-Codex plugin installation failures?

The best way to troubleshoot Oh-My-Codex plugin installation failures is to run diagnostic checks that scan plugin caches and legacy content. This identifies outdated versions and automates the required fixes to restore your environment.