debug

Analyze logs and diagnose root causes with structured debugging steps.

49|3|Updated Jan 22, 2026
One-click install
npx skills add https://github.com/xiaobei930/claude-code-best-practices --skill debug-xiaobei930
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debug
Source: https://github.com/xiaobei930/claude-code-best-practices/tree/main/skills/debug
Command: npx skills add https://github.com/xiaobei930/claude-code-best-practices --skill debug-xiaobei930

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Quickly identify and diagnose software issues through a structured debugging workflow, reducing time to resolution.

Core Features & Use Cases

  • Guiding steps for log analysis, performance diagnostics, and root-cause investigations.
  • Checklists and evidence collection to document findings and verify fixes.
  • Use Case: When an incident hits production, follow the flow to reproduce, narrow down, and validate.

Quick Start

Start by reproducing the issue, collect logs and metrics, and follow the structured steps to identify the root cause.

Frequently Asked Questions about debug

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

FAQPage Schema
How do I debug software issues in production using a structured workflow?

To debug software issues in production, follow a structured workflow that guides you to reproduce the issue, collect logs and metrics, and investigate root causes. This approach narrows down problems and validates fixes systematically.

What is the best way to analyze logs and diagnose performance problems during troubleshooting?

The best way to analyze logs and diagnose performance problems is to use structured steps and checklists for evidence collection. This ensures you document findings thoroughly and verify fixes during root-cause investigations.

Can I use structured debugging for root-cause investigation in production systems?

Yes, you can use structured debugging for root-cause investigation in production systems. It applies to codebases and services, providing guidance for triage and validation to resolve incidents faster.

How do I start troubleshooting when an incident hits my production environment?

When an incident hits production, start by reproducing the issue and collecting logs and metrics. Follow the structured debugging steps to identify the root cause and validate your resolution.

Does structured debugging work for diagnosing performance problems in codebases and services?

Yes, structured debugging works for diagnosing performance problems in codebases and services. It streamlines workflows by applying checklists and evidence collection to investigate root causes effectively.

What should I do if my software debugging process is not finding the root cause?

If your software debugging process is not finding the root cause, ensure you are following structured steps for evidence collection and triage. Proper log analysis and performance diagnostics are essential to narrow down the issue.