cx-doctor

Diagnose project health issues across docs, memory files, git hooks, and MCP configurations.

Updated Mar 25, 2026
One-click install
npx skills add https://github.com/AngelMaldonado/skills --skill cx-doctor
Or copy as Structured Prompt for Agentβ–Ό
Please help me install this Agent Skill.
Skill: cx-doctor
Source: https://github.com/AngelMaldonado/skills/tree/main/.claude/skills/cx-doctor
Command: npx skills add https://github.com/AngelMaldonado/skills --skill cx-doctor

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Diagnoses and reports project health issues across docs/, memory files, git hooks, and MCP configurations to reduce debugging time and configuration drift.

Core Features & Use Cases

  • Performs comprehensive checks on documentation structure, memory files, git hooks, and MCP settings to surface clear pass/warn/error results.
  • Provides actionable remediation suggestions and safe, guided steps to fix detected issues.
  • Works after cx init or when a command fails, and can run periodically to monitor ongoing project health.

Quick Start

Run cx doctor at the root of your project to scan health and review recommended fixes.

Frequently Asked Questions about cx-doctor

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

FAQPage Schema
How do I run a health check on my project configuration and documentation?β–Ό

Run a health check command at your project root to scan documentation, memory files, git hooks, and MCP configurations, returning clear pass, warn, or error results to reduce debugging time.

Can I automatically fix configuration drift and git hook issues?β–Ό

Yes, you can apply remediation by running the health check with an optional fix flag, which proposes safe, guided steps and requires explicit approval before modifying any detected configuration drift.

What is the best way to monitor project health during long development sessions?β–Ό

The best way to monitor ongoing project health is to run the diagnostic scan periodically during long work sessions or immediately after another command errors to surface and resolve configuration issues.

Do I need to initialize my project before diagnosing setup issues?β–Ό

Yes, you should initialize your project setup first; the diagnostic scan is specifically designed to verify that setup and detect any configuration drift immediately after initialization.

Why does the health check report warnings for my memory files and docs?β–Ό

The health check reports warnings for memory files and docs because it performs comprehensive structural checks across your project to surface clear results and actionable remediation suggestions for any detected issues.

Will the diagnostic scan modify my files without permission?β–Ό

No, the diagnostic scan operates in a default read-only mode to report issues, and will only apply remediation after explicit developer approval when using the optional fix flag.