doctor

Diagnose oh-my-ccg configuration and environment issues across local or CI environments.

1|Updated Feb 23, 2026
One-click install
npx skills add https://github.com/1molchuan/oh-my-ccg --skill doctor-1molchuan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: doctor
Source: https://github.com/1molchuan/oh-my-ccg/tree/main/skills/doctor
Command: npx skills add https://github.com/1molchuan/oh-my-ccg --skill doctor-1molchuan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Diagnose and fix installation issues for oh-my-ccg by verifying plugin artifacts, environment, and server accessibility.

Core Features & Use Cases

  • Health checks: verify plugin manifest, hooks registration, MCP server availability (tools/codex/gemini), and required state directories.
  • Environment validation: ensure .oh-my-ccg directory structure, Node.js version, and TypeScript build readiness; confirm Codex and Gemini CLIs when available.
  • Guided remediation: provide actionable fixes and restart guidance to restore a healthy runtime.

Quick Start

Run the doctor skill to diagnose and report installation health for your oh-my-ccg setup.

Frequently Asked Questions about doctor

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

FAQPage Schema
Why does my oh-my-ccg installation fail to run correctly?

oh-my-ccg installation failures often stem from incorrect plugin manifests, missing state directories, or unavailable MCP servers. Diagnosing the setup verifies plugin artifacts, environment configurations, and server connectivity to identify the root cause.

How do I troubleshoot MCP server connectivity issues for tools like Codex and Gemini?

To troubleshoot MCP server connectivity, run a health check that verifies server availability for Codex and Gemini tools. This validates CLI tool availability, server responses, and state directory configurations to isolate and report connection issues.

What do I need to validate before building TypeScript for Node environments?

Validating TypeScript build readiness for Node environments requires confirming the Node.js version and checking the .oh-my-ccg directory structure. Environment validation ensures all build prerequisites and CLI dependencies are properly configured.

How do I diagnose plugin manifest and hooks registration problems?

Diagnosing plugin manifest and hooks registration problems involves checking plugin artifacts and verifying hook configurations within the oh-my-ccg setup. A diagnostic health check reports any missing or malformed registrations preventing normal operation.

Can I run installation health checks in CI environments?

Yes, installation health checks apply to both local and CI environments. The diagnostic process verifies TypeScript build outcomes, OpenSpec availability, and CLI tool versions across different environments to ensure consistent runtime health.

What is the best way to fix OpenSpec availability and state directory errors?

The best way to fix OpenSpec availability and state directory errors is through guided remediation. This provides actionable fixes and restart guidance after verifying the .oh-my-ccg directory structure and OpenSpec access to restore a healthy runtime.