superpowers-doctor

What problem does it solve?

Diagnoses wide-ranging integrity and configuration problems across a local skill ecosystem so broken or degraded skills are detected before they cause downstream failures. It surfaces malformed YAML, name mismatches, dead references, trigger collisions, orphaned installs, content and reference drift, CRLF and UTF-8 BOM issues, stale or dirty checkouts, reviewer/agent rendering drift, and other structural defects.

Core Features & Use Cases

• Comprehensive scan: Runs 27 harsh, tiered checks across every installed skill to classify findings as critical, error, warning, or info.
• Graduated remediation: Supports report-only mode plus --fix-safe, --fix, and --fix --purge-orphans flags with verified backups before any change.
• Platform-aware diagnostics: Detects WSL/NTFS issues, overlay vs source drift, and optionally exercises python3/node-based checks for TODO and reviewer-dispatch validation.
• Use Case: Run after bulk skill edits, after cloning on Windows, or as a pre-release audit to catch corruption and configuration regressions.

Quick Start

Run the superpowers doctor to audit all installed skills and produce a categorized diagnostic report.