# Troubleshoot

> Isolate root causes and propose targeted fixes with clear validation steps.

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

---


# Troubleshoot

## Objective
- Reproduce and isolate the issue.
- Identify the most probable root cause and next actions.

## When to use
- A bug or failure is reported or observed.
- Symptoms are unclear and need narrowing down.

## Inputs
- User-reported symptoms, logs, or reproduction steps.
- AGENTS.md, rules, relevant code/tests.
- Environment details if available.

## Process
1) Confirm and restate the symptom; note missing repro info.
2) Form quick hypotheses; prioritize simplest checks.
3) Collect minimal evidence (logs/tests/inputs) to confirm/deny hypotheses.
4) Identify the likely root cause or narrow to top candidates.
5) Propose next actions (fix path or deeper check) and validation steps.

## Outputs
- Likely root cause (or narrowed hypotheses).
- Evidence collected and what’s still unknown.
- Proposed fix direction and validation plan.

## Edge cases
- If repro is missing, request exact steps or data.
- Avoid broad changes; focus on evidence-driven narrowing.