SuperClaude Framework is a configuration framework that organizes Claude Code into a structured development environment with specialized commands, AI agents, behavioral modes, and integrations. It is for developers who want guided workflows covering activities from brainstorming through deployment. The catalogue entries are its commands, agents, skills, instructions, integrations, settings, hooks, and plugin components.
Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx agentmods add commands/superclaude-org/superclaude_framework/troubleshootgit clone --depth 1 https://github.com/SuperClaude-Org/SuperClaude_FrameworkWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/commands/superclaude-org/superclaude_framework/troubleshoot)<a href="https://agentmods.dev/commands/superclaude-org/superclaude_framework/troubleshoot"><img src="https://agentmods.dev/badge/commands/superclaude-org/superclaude_framework/troubleshoot.svg" alt="Measured on agentmods" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00019 | $0.00647 |
| Opus 5 | $0.00010 | $0.00324 |
| Sonnet 5 | $0.00004 | $0.00129 |
| Haiku 4.5 | $0.00002 | $0.00065 |
Grade A, and why
troubleshoot scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 6d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 88 lines — stays where its author put it; the contents beside it link to each section on GitHub.
/sc:troubleshoot - Issue Diagnosis and Resolution
Triggers
- Code defects and runtime error investigation requests
- Build failure analysis and resolution needs
- Performance issue diagnosis and optimization requirements
- Deployment problem analysis and system behavior debugging
Usage
/sc:troubleshoot [issue] [--type bug|build|performance|deployment] [--trace] [--fix]
Behavioral Flow
- Analyze: Examine issue description and gather relevant system state information
- Investigate: Identify potential root causes through systematic pattern analysis
- Debug: Execute structured debugging procedures including log and state examination
- Propose: Validate solution approaches with impact assessment and risk evaluation
- Resolve: Apply appropriate fixes and verify resolution effectiveness
Key behaviors:
- Systematic root cause analysis with hypothesis testing and evidence collection
- Multi-domain troubleshooting (code, build, performance, deployment)
- Structured debugging methodologies with comprehensive problem analysis
- Safe fix application with verification and documentation
Tool Coordination
- Read: Log analysis and system state examination
- Bash: Diagnostic command execution and system investigation
- Grep: Error pattern detection and log analysis
- Write: Diagnostic reports and resolution documentation
Key Patterns
- Bug Investigation: Error analysis → stack trace examination → code inspection → fix validation
- Build Troubleshooting: Build log analysis → dependency checking → configuration validation
- Performance Diagnosis: Metrics analysis → bottleneck identification → optimization recommendations
- Deployment Issues: Environment analysis → configuration verification → service validation
Examples
Code Bug Investigation
/sc:troubleshoot "Null pointer exception in user service" --type bug --trace
# Systematic analysis of error context and stack traces
# Identifies root cause and provides targeted fix recommendations
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 6d ago First seen · 88 lines · 19 tokens per session scan A 4592f6456509
troubleshoot is a command published in the GitHub repository SuperClaude-Org/SuperClaude_Framework (23,871 stars, last pushed 16d ago), licensed MIT. It adds 19 tokens to every session and 647 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
Other commands, from other repositories
troubleshoot
Diagnose and resolve issues in code, builds, deployments, and system behavior.
analyze
Comprehensive code analysis across quality, security, performance, and architecture domains.
analyze
Comprehensive code analysis across quality, security, performance, and architecture domains.
troubleshoot
Diagnose and resolve issues in code, builds, deployments, and system behavior.
troubleshoot
Diagnose and resolve issues in code, builds, deployments, and system behavior.
step-research
Always research before proposing a fix. The Untether bug you're chasing is often a known upstream engine quirk, a previously-fixed regression, or a documented config gotcha.