doctor

Diagnose oh-my-claudecode installation and configuration issues in Claude Code.

Updated Feb 20, 2026
One-click install
npx skills add https://github.com/ssccio/cc-on-web-base --skill doctor-ssccio
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: doctor
Source: https://github.com/ssccio/cc-on-web-base/tree/main/skills/doctor
Command: npx skills add https://github.com/ssccio/cc-on-web-base --skill doctor-ssccio

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you identify why Claude on Web (oh-my-claudecode) isn’t behaving correctly by running installation and configuration diagnostics and then guiding cleanup of common legacy and cache issues.

Core Features & Use Cases

  • Plugin version & cache verification: Detects missing, outdated, or stale multiple cached versions of oh-my-claudecode.
  • Legacy configuration checks: Finds legacy "hooks" entries in ~/.claude/settings.json and detects old hook scripts that can cause duplicate or conflicting behavior.
  • Installation integrity checks: Verifies ~/.claude/CLAUDE.md presence and the expected OMC marker, and checks for legacy-installed agents/commands/skills that should now be provided by the plugin.
  • Report + optional remediation: Produces a structured health report and includes safe, targeted auto-fix commands after user confirmation.

Quick Start

Ask the AI to run the doctor diagnostics to produce an OMC Doctor Report for your current ~/.claude installation.

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-claudecode installation issues in Claude Code?

To diagnose oh-my-claudecode installation issues, run the doctor diagnostics to inspect ~/.claude/settings.json, hooks, CLAUDE.md, and plugin cache, producing a structured health report for your local environment.

Why does my Claude Code configuration have conflicting or duplicate behavior?

Conflicting Claude Code behavior often stems from legacy "hooks" entries in ~/.claude/settings.json and old hook scripts. Diagnostics detect these legacy configurations and guide targeted cleanup to resolve duplicates.

How do I fix stale plugin cache and outdated oh-my-claudecode versions?

Fix stale plugin cache and outdated oh-my-claudecode versions by running diagnostics that detect multiple cached versions, then applying safe, targeted auto-fix commands after user confirmation to clean the cache.

What is a CLAUDE.md marker and why does my oh-my-claudecode setup need it?

A CLAUDE.md marker verifies installation integrity in ~/.claude. Diagnostics check for its presence and expected OMC marker, ensuring your oh-my-claudecode setup is correctly recognized and configured.

Can I automatically repair legacy hook scripts and settings.json entries?

Yes, you can repair legacy hook scripts and settings.json entries by generating a remediation plan from the health report, then executing safe, targeted auto-fix commands after confirming the changes.

Does the doctor diagnostics check for legacy installed agents and commands?

Yes, diagnostics check for legacy-installed agents, commands, and skills that should now be provided by the oh-my-claudecode plugin, ensuring your installation integrity is maintained without conflicting legacy content.