omc-doctor

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

5|Updated Mar 16, 2026
One-click install
npx skills add https://github.com/RobinNorberg/oh-my-copilot --skill omc-doctor-robinnorberg
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: omc-doctor
Source: https://github.com/RobinNorberg/oh-my-copilot/tree/main/skills/omc-doctor
Command: npx skills add https://github.com/RobinNorberg/oh-my-copilot --skill omc-doctor-robinnorberg

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Diagnose and fix oh-my-copilot installation issues across local environments, ensuring the Copilot plugin runs with correct configurations.

Core Features & Use Cases

  • Detect plugin version mismatches, legacy hooks, and outdated copilot-instructions configurations.
  • Validate COPILOT_CONFIG_DIR paths, settings.json presence, and plugin cache integrity to reduce downtime.
  • Provide safe remediation steps including cache cleanup, removing deprecated content, and guided setup updates for local environments.

Quick Start

Run the doctor skill to diagnose and repair your oh-my-copilot setup.

Frequently Asked Questions about omc-doctor

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

FAQPage Schema
How do I diagnose Copilot installation issues and fix configuration errors?

Diagnose Copilot installation issues by running the doctor skill to verify plugin installation, detect legacy hooks, validate the COPILOT_CONFIG_DIR path, and check settings.json. It provides guided remediation steps to repair local configurations safely.

Why does my Copilot plugin have configuration problems after an update?

Copilot plugin configuration problems after updates are often caused by legacy hooks, outdated copilot-instructions, or cache corruption. Run diagnostics to detect version mismatches and deprecated scripts, then follow safe remediation steps to remove outdated content and clear caches.

How do I validate COPILOT_CONFIG_DIR paths and settings.json for my Copilot setup?

Validate COPILOT_CONFIG_DIR paths and settings.json presence by running a health check that reads and interprets your local configuration structure. This verifies plugin cache integrity and ensures the Copilot plugin runs with the correct settings.

What is the best way to remove legacy hooks and outdated Copilot-instructions configurations?

The best way to remove legacy hooks and outdated Copilot-instructions is through guided remediation that identifies deprecated files and scripts, performs safe cache clearance, removes obsolete content, and applies updated setup instructions for local environments.

Can I fix oh-my-copilot plugin version mismatches on a local setup?

Yes, you can fix oh-my-copilot plugin version mismatches on a local setup by running diagnostics that detect version discrepancies and validate plugin cache integrity, followed by applying safe remediation steps including cache cleanup and guided setup updates.

What should I do when Copilot troubleshooting detects deprecated scripts but the plugin still fails?

When Copilot troubleshooting detects deprecated scripts but the plugin still fails, perform a full cache clearance, remove all identified legacy hooks and outdated instructions, then rerun the health check to validate that settings.json and COPILOT_CONFIG_DIR paths are correctly configured.