# Troubleshoot

> Diagnose and resolve issues in code, builds, or system behavior

- Skill: `nicolasestrem/troubleshoot` (Agent Skill)
- Install (CLI): `npx skillmds@latest add nicolasestrem/troubleshoot`
- Raw SKILL.md: https://api.skillmd.com/api/skills/nicolasestrem/troubleshoot/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: nicolasestrem (https://skillmd.com/u/nicolasestrem)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/nicolasestrem/troubleshoot

---


# Troubleshoot

Issue Diagnosis and Resolution

## Purpose
Systematically diagnose and resolve issues in code, builds, deployments, or system behavior.

## Usage
```
/troubleshoot [issue] [--type bug|build|performance|deployment] [--trace] [--fix]
```

## Arguments
- `issue` - Description of the problem or error message
- `--type` - Issue category (bug, build, performance, deployment)
- `--trace` - Enable detailed tracing and logging
- `--fix` - Automatically apply fixes when safe

## Execution
1. Analyze issue description and gather initial context
2. Identify potential root causes and investigation paths
3. Execute systematic debugging and diagnosis
4. Propose and validate solution approaches
5. Apply fixes and verify resolution

## Claude Code Integration
- Uses Read for error log analysis
- Leverages Bash for runtime diagnostics
- Applies Grep for pattern-based issue detection
- Maintains structured troubleshooting documentation