troubleshooting

Diagnoses software errors by analyzing logs, stack traces, and reproduction steps.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/swat9013/dotfiles --skill troubleshooting-swat9013
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: troubleshooting
Source: https://github.com/swat9013/dotfiles/tree/main/.claude-global/skills/troubleshooting
Command: npx skills add https://github.com/swat9013/dotfiles --skill troubleshooting-swat9013

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Provides a structured, hypothesis-driven workflow to investigate software bugs and runtime errors, helping teams distinguish direct causes from deeper root causes and avoid guesswork when applying fixes.

Core Features & Use Cases

  • Guided information collection: Ask for the minimal necessary inputs such as error messages, stack traces, reproduction steps, recent changes, and relevant logs.
  • Systematic isolation & verification: Recommend divide-and-conquer tactics (code, time, input spaces), git bisect, and focused tests to narrow failure scope.
  • Hypothesis loop & evidence tracking: Emphasize refutation-first tests, 5 Whys tracing with evidence, and clear decision rules for immediate fixes, escalation, or long-term redesign.
  • Operational artifacts: Ship a reproducible debug report using the provided template and reference patterns for log analysis and tool strategies.

Quick Start

Invoke the troubleshooting skill with an error message, stack trace, or log path, for example: /troubleshooting TypeError: Cannot read property 'x' of undefined

Frequently Asked Questions about troubleshooting

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I find the root cause of a runtime exception using a hypothesis-driven workflow?

To find the root cause of a runtime exception, use a hypothesis-driven workflow that collects error messages and stack traces, applies refutation-first tests, and traces 5 Whys with evidence to isolate the failure scope. It distinguishes direct causes from deeper root causes.

What is the best way to debug intermittent failures and analyze application logs?

The best way to debug intermittent failures is through systematic isolation using log analysis and divide-and-conquer tactics. This approach inspects relevant logs to verify hypotheses, narrowing the failure scope without guesswork.

How do I use git bisect to identify when a regression was introduced?

To identify when a regression was introduced, use git bisect to perform systematic isolation across code changes. This method divides the timeline to narrow failure scope and verify the exact commit causing the software error.

Can I use structured troubleshooting for UI and display issues in production environments?

Yes, you can use structured troubleshooting for UI and display issues in production environments. It diagnoses software errors through evidence-based verification, applying hypothesis-driven tests to identify root causes and propose actionable fixes.

What information do I need to provide to start an incident response investigation?

To start an incident response investigation, provide error messages, stack traces, logs, reproduction steps, and recent changes. This guided information collection drives the hypothesis loop and evidence tracking to generate a reproducible debug report.