troubleshoot

Installation
SKILL.md

Troubleshooting Protocol

Follow this systematic root cause analysis process. NEVER retry the same approach without understanding WHY it failed.

Protocol

  1. STOP: Do not re-execute the same command
  2. Observe: What exactly happened? What was expected?
  3. Hypothesize: What could cause this? (list 2-3 possibilities)
  4. Investigate: Check official docs, logs, stack traces, config
  5. Root Cause: Identify the fundamental cause (not symptoms)
  6. Fix: Implement a solution that addresses the root cause
  7. Verify: Confirm the fix works
  8. Learn: Document the solution for future reference

Anti-Patterns (strictly prohibited)

Installs
37
GitHub Stars
23.5K
First Seen
May 15, 2026
troubleshoot — superclaude-org/superclaude_framework