Debugging

Diagnose and fix software bugs through structured root-cause analysis.

3|Updated Sep 27, 2025
One-click install
npx skills add https://github.com/Sheldon-92/TAD --skill debugging-sheldon-92
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Debugging
Source: https://github.com/Sheldon-92/TAD/tree/main/.tad/skills/debugging
Command: npx skills add https://github.com/Sheldon-92/TAD --skill debugging-sheldon-92

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Debugging can be time-consuming and error-prone without a repeatable approach. This skill provides a structured workflow to diagnose, isolate, and fix root causes while maintaining evidence and quality.

Core Features & Use Cases

  • Root-cause analysis workflow: reproduce, isolate, analyze, fix, and verify.
  • Evidence-based debugging: captures logs, steps, and decisions to prevent regressions.
  • Cross-domain applicability: useful for runtime errors, failing tests, performance issues, and logic bugs across languages and stacks.

Quick Start

Reproduce the issue in your project and follow the structured debugging process to locate the root cause.

Frequently Asked Questions about Debugging

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

FAQPage Schema
How do I find the root cause of a flaky test or runtime error?

To find the root cause of a flaky test or runtime error, follow a structured workflow: reproduce, isolate, analyze, fix, and verify the issue. This approach systematically narrows down the codebase to pinpoint the exact failure.

What is the best way to fix performance issues and logic bugs without causing regressions?

Fixing performance issues and logic bugs without regressions requires evidence-based debugging that captures logs, steps, and decisions. By documenting the analysis process, you maintain clear proof of the root cause and prevent future code regressions.

Can I use this structured debugging workflow across different programming languages and tech stacks?

Yes, you can use this structured debugging workflow across different programming languages and tech stacks. It provides cross-domain applicability for runtime errors, failing tests, performance issues, and logic bugs in any software project.

How do I start debugging a bug if I cannot reliably reproduce the issue?

To start debugging an unreliable issue, first focus on the reproduction phase of the workflow. Attempt to replicate the environment and steps that triggered the bug, as establishing a reproducible state is the required first step before isolating the root cause.

Does root-cause analysis help with fixing failing tests or is it only for runtime errors?

Root-cause analysis helps with both fixing failing tests and resolving runtime errors. The structured process operates across multiple domains including flaky tests, performance issues, and logic failures to identify and fix the underlying problem.

What are the limitations of using a structured debugging process for code analysis?

The limitation of a structured debugging process is its reliance on reproducibility; if a bug cannot be consistently reproduced or logs lack sufficient evidence, isolating the root cause becomes significantly harder and may require alternative code-analysis strategies.