SweetClaude Doctor

Diagnose and repair SweetClaude project configuration and state files.

6|3|Updated Apr 12, 2026
One-click install
npx skills add https://github.com/carson-sweet/sweetclaude --skill sweetclaude-doctor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: SweetClaude Doctor
Source: https://github.com/carson-sweet/sweetclaude/tree/main/skills/doctor
Command: npx skills add https://github.com/carson-sweet/sweetclaude --skill sweetclaude-doctor

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python3, and includes scripts (resource) components.

What problem does it solve?

This Skill resolves configuration drift, state corruption, and structural inconsistencies in SweetClaude projects by providing a safe, reversible, and automated diagnostic and repair pipeline.

Core Features & Use Cases

  • Diagnostic Scanning: Performs comprehensive checks across state integrity, hooks, storage, and environment configuration.
  • Reversible Repairs: Executes fixes through a protected pipeline that creates backups and git safety branches, allowing for full rollbacks if needed.
  • Maintenance Orchestration: Manages project migrations, compatibility mode graduation, and recovery from broken states without manual file manipulation.

Quick Start

Invoke the doctor skill to perform a full diagnostic scan of your project and automatically apply recommended repairs.

Frequently Asked Questions about SweetClaude Doctor

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

FAQPage Schema
How do I fix configuration drift and state corruption in my project files?

Fix configuration drift and state corruption by running an automated diagnostic scan that detects structural inconsistencies across state integrity, hooks, and storage, then applies reversible repairs with mandatory backups.

What is the safest way to automate project maintenance and taxonomy migration?

Safe project maintenance and taxonomy migration use a dedicated execution pipeline that creates backups and git safety branches before applying structural repairs, ensuring you can execute a full rollback if needed.

How does automated structural repair handle broken project states without manual file manipulation?

Automated structural repair handles broken states by orchestrating recovery through a protected pipeline that scans eight distinct categories, including state integrity and hook health, to apply fixes without manual intervention.

Can I run diagnostic scans and automated repairs using Python3 scripts?

Yes, you can run these automated diagnostic scans and structural repairs using Python3 scripts, which execute comprehensive checks across environment configuration, storage, and hook health before applying safe, reversible fixes.

What happens if an automated repair breaks my project configuration?

If an automated repair breaks your configuration, the pipeline's mandatory backup and rollback capabilities allow you to revert the file mutations completely, ensuring safe and reversible project state recovery.

When do I need to run compatibility mode graduation for my project?

Run compatibility mode graduation during maintenance orchestration when you need to migrate project configurations and resolve structural inconsistencies to ensure ongoing project consistency and compatibility.