omc-doctor

Verify oh-my-claude installation integrity, hook scripts, and state-root writability.

3|Updated Apr 6, 2026
One-click install
npx skills add https://github.com/X0x888/oh-my-claude --skill omc-doctor-x0x888
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: omc-doctor
Source: https://github.com/X0x888/oh-my-claude/tree/main/bundle/dot-claude/skills/omc-doctor
Command: npx skills add https://github.com/X0x888/oh-my-claude --skill omc-doctor-x0x888

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill performs a comprehensive health check on the oh-my-claude installation, ensuring that all core files and configurations are in place and functioning correctly.

Core Features & Use Cases

  • Core File Verification: Checks for the presence and integrity of core oh-my-claude files.
  • Hook Script Validation: Ensures that hook scripts are executable and properly wired.
  • State-Root Writability: Verifies that the state-root directory is writable, allowing for successful installations.
  • Use Case: If the harness feels off or gates are not firing, this skill can quickly diagnose common issues without requiring a source clone.

Quick Start

Run the installed-tree diagnostic by executing the following command in your terminal:

bash ~/.claude/skills/autowork/scripts/omc-doctor.sh

Frequently Asked Questions about omc-doctor

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

FAQPage Schema
How do I run a health check on my oh-my-claude installation?

Run a health check on oh-my-claude installations by executing the bash script `~/.claude/skills/autowork/scripts/omc-doctor.sh` in your terminal to verify core file integrity and configuration.

Why are my oh-my-claude hook scripts not firing correctly?

Hook scripts may not fire if they lack execution permissions or are improperly wired. A diagnostic health check validates hook script execution and verifies core installation files without needing a source clone.

How to verify if the oh-my-claude state-root directory is writable?

Verify state-root directory writability by running the oh-my-claude diagnostic script. It checks directory permissions to ensure successful installations and gates can write state data properly.

Do I need to clone the oh-my-claude source repository to troubleshoot installation issues?

You do not need to clone the source repository to troubleshoot oh-my-claude installation issues. The diagnostic script runs directly on the installed tree to check core files, hooks, and directory writability.

What does oh-my-claude installation verification check for?

Oh-my-claude installation verification checks for the presence and integrity of core files, validates that hook scripts are executable and properly wired, and confirms the state-root directory is writable.