superclaude-org/troubleshoot
plugins/superclaude/skills/troubleshoot/SKILL.md
Systematic troubleshooting with root cause analysis. Use when users report errors, bugs, or unexpected behavior. Never retry without understanding why.
$ install --global
skillsauthnpx skillsauth add superclaude-org/superclaude_framework troubleshootInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 15, 2026, 4:23 AM6.1s1 file scanned
SKILL.md
- name:
- troubleshoot
- description:
- Systematic troubleshooting with root cause analysis. Use when users report errors, bugs, or unexpected behavior. Never retry without understanding why.
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
Related Skills
superclaude-org/Confidence Check
testing
VerifiedTrustedCommunity
Pre-implementation confidence assessment (≥90% required). Use before starting any implementation to verify readiness with duplicate check, architecture compliance, official docs verification, OSS references, and root cause identification.
22,514SKILL.mdUpdated Apr 28, 2026
superclaude-org/Confidence Check
testing
VerifiedTrustedCommunity
Pre-implementation confidence assessment (≥90% required). Use before starting any implementation to verify readiness with duplicate check, architecture compliance, official docs verification, OSS references, and root cause identification.
22,514SKILL.mdUpdated Apr 28, 2026
superclaude-org/Confidence Check
testing
VerifiedTrustedCommunity
Pre-implementation confidence assessment (≥90% required). Use before starting any implementation to verify readiness with duplicate check, architecture compliance, official docs verification, OSS references, and root cause identification.
22,514SKILL.mdUpdated Apr 28, 2026
superclaude-org/token-efficiency
testing
VerifiedTrustedCommunity
Activate ultra-compressed output mode for maximum token efficiency. Use when context is running low, user requests brevity, or dealing with large-scale operations.
22,303SKILL.mdUpdated Apr 15, 2026