ce:doctor

Diagnose CLI tools, MCP servers, and authentication status with optional auto-fix.

6|2|Updated Jan 30, 2026
One-click install
npx skills add https://github.com/Jerrylalala/compound-engineering --skill ce-doctor-jerrylalala
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ce:doctor
Source: https://github.com/Jerrylalala/compound-engineering/tree/main/plugins/compound-engineering/skills/ce-doctor
Command: npx skills add https://github.com/Jerrylalala/compound-engineering --skill ce-doctor-jerrylalala

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Setting up a multi-tool AI engineering environment involves many moving parts—Codex CLI, Gemini CLI, GitHub CLI, MCP servers, and authentication—and a single missing piece silently breaks downstream workflows. This Skill runs a structured health check that detects every component's status and can automatically repair required items. ## Core Features & Use Cases - Comprehensive Detection: Checks Codex/Gemini/GitHub CLI installation and versions, GitHub and Context7 MCP server configuration, version consistency, and handoff protocol integrity. - One-Click Auto-Fix: The --fix flag automatically installs missing required components such as Codex CLI, Gemini CLI, and the GitHub MCP server. - Smoke Testing: The --smoke flag verifies that installed CLIs can actually execute tasks, not just report a version. - Use Case: After installing the plugin on a new machine, run the doctor check to get a Markdown report table showing PASS/WARN/FAIL for each component, then rerun with --fix to install everything missing before starting real work. ## Quick Start Run the doctor health check with the fix flag to detect and automatically repair my CLI tools and MCP server configuration.

Frequently Asked Questions about ce:doctor

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

FAQPage Schema
How do I check if Codex CLI and Gemini CLI are installed correctly?▼

Run the doctor health check, which verifies each CLI by locating the binary and querying its version. Missing tools are reported as FAIL with the exact install command, such as npm install -g @openai/codex for Codex.

How to diagnose GitHub MCP server configuration in Claude Code?▼

The health check runs claude mcp list and greps for the GitHub MCP entry. If missing, it provides the claude mcp add command with the GitHub Copilot MCP endpoint, and reminds you to restart Claude Code afterward.

Can the doctor check automatically fix missing dependencies?▼

Yes, passing the --fix flag automatically installs missing required items including Codex CLI, Gemini CLI, and the GitHub MCP server. Optional components like agent-browser are never auto-installed, and MCP changes require a Claude Code restart.

What is the difference between --fix and --smoke flags?▼

The --fix flag repairs failed required checks, while --smoke runs an execution test (such as piping a command through codex exec) to confirm the CLI actually works. Both flags can be combined in a single run.

Why does GitHub MCP not work after the doctor auto-fix?▼

MCP server configuration changes only take effect after restarting Claude Code. The doctor explicitly warns about this after a successful fix, so restart the client before expecting the GitHub MCP tools to appear.