troubleshoot

Reproduce, isolate, and determine root causes of software bugs.

2|Updated Dec 31, 2025
One-click install
npx skills add https://github.com/leanbusqts/agent47 --skill troubleshoot-leanbusqts
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: troubleshoot
Source: https://github.com/leanbusqts/agent47/tree/main/templates/skills/troubleshoot
Command: npx skills add https://github.com/leanbusqts/agent47 --skill troubleshoot-leanbusqts

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

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

Core Features & Use Cases

  • Structured debugging workflow: Reproduce, hypothesize, gather evidence, and identify root causes.
  • Evidence-driven actions: Generate a concrete plan with validation steps to confirm fixes.
  • Use Case: When a bug report lacks reproducible steps, guide stakeholders to collect necessary inputs and propose actionable remedies.

Quick Start

  • List symptoms, gather logs, and reproduce steps.
  • Form hypotheses and collect minimal evidence.
  • Propose a validated fix path with a clear testing plan.

Frequently Asked Questions about troubleshoot

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

FAQPage Schema
How do I find the root cause of a software bug when reproduction steps are missing?

To find the root cause of a software bug with missing reproduction steps, apply a structured debugging workflow to confirm symptoms, form hypotheses, collect minimal evidence, and isolate the actual failure point. This approach guides stakeholders to gather necessary inputs.

What is the best way to isolate complex software failures across different environments?

The best way to isolate complex software failures is through evidence-driven analysis, collecting minimal logs and symptoms to validate hypotheses. This structured workflow determines the root cause across code, tests, and environments to propose targeted fixes.

How do I create a validation plan after fixing a software defect?

To create a validation plan after fixing a software defect, generate a concrete testing path that confirms the targeted fix. This ensures the isolated root cause is resolved and prevents regression by enforcing structured evidence collection and hypothesis confirmation.

Can I use a structured debugging workflow for defects with unclear symptoms?

Yes, you can use a structured debugging workflow for defects with unclear symptoms. It systematically reproduces the issue, forms hypotheses, and gathers minimal evidence to pinpoint the root cause and propose actionable remedies with validation.

What evidence do I need to collect to troubleshoot complex software failures?

To troubleshoot complex software failures, you need to collect minimal evidence such as logs, reproduction steps, and symptom confirmations. This evidence validates hypotheses and isolates the root cause across code and test environments for targeted fixes.