superclaude-org/superclaude_framework48 installs
troubleshoot
Systematic troubleshooting with root cause analysis. Use when users report errors, bugs, or unexpected behavior. Never retry without understanding why.
How do I install this agent skill?
npx skills add https://github.com/superclaude-org/superclaude_framework --skill troubleshootIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill establishes a systematic troubleshooting framework. It contains no code or commands. The only potential issue is the lack of input sanitization for user-provided arguments, which is a common characteristic of prompt-based skills.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
Troubleshooting Protocol
Follow this systematic root cause analysis process. NEVER retry the same approach without understanding WHY it failed.
Protocol
- STOP: Do not re-execute the same command
- Observe: What exactly happened? What was expected?
- Hypothesize: What could cause this? (list 2-3 possibilities)
- Investigate: Check official docs, logs, stack traces, config
- Root Cause: Identify the fundamental cause (not symptoms)
- Fix: Implement a solution that addresses the root cause
- Verify: Confirm the fix works
- Learn: Document the solution for future reference
Anti-Patterns (strictly prohibited)
- "Got an error. Let's just try again"
- "Retry: attempt 1... attempt 2... attempt 3..."
- "It timed out, so let's increase the wait time" (ignoring root cause)
- "There are warnings but it works, so it's fine" (future technical debt)
Required Format
## Root Cause Analysis
**Error**: [Exact error message]
**Expected**: [What should have happened]
**Cause**: [Root cause with evidence]
**Fix**: [Solution addressing root cause]
**Prevention**: [How to prevent recurrence]
Apply this to: $ARGUMENTS
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/superclaude-org/superclaude_framework/troubleshoot">View troubleshoot on skillZs</a>