debugging-errors

Diagnose runtime errors and performance issues in production systems.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/mykaarma/claude-sutras --skill debugging-errors
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: debugging-errors
Source: https://github.com/mykaarma/claude-sutras/tree/main/skills/debugging-errors
Command: npx skills add https://github.com/mykaarma/claude-sutras --skill debugging-errors

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill helps engineers systematically diagnose and resolve runtime exceptions, performance issues, and production incidents, reducing downtime and manual guesswork.

Core Features & Use Cases

  • Structured debugging workflow: A checklist guiding evidence gathering, error classification, isolation, root‑cause identification, and verification.
  • Error classification reference: Tables mapping symptoms to likely categories and first‑check actions.
  • Async and distributed system tips: Specific patterns for missing await, event‑loop issues, connection‑pool exhaustion, and correlation‑ID tracing. Use case example: When a service throws intermittent ClientConnectorError, the skill directs you to gather logs, use correlation IDs, and apply retry/backoff patterns.

Quick Start

Ask the debugging-errors skill to walk you through fixing the current production incident.

Frequently Asked Questions about debugging-errors

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

FAQPage Schema
How do I debug intermittent production errors in distributed systems?▼

Debug intermittent production errors in distributed systems by gathering logs, using correlation IDs for tracing, and applying retry or backoff patterns. A structured workflow guides evidence collection, error classification, and root-cause isolation to resolve incidents fast.

What is the best way to diagnose slow responses and performance issues during an incident?▼

Diagnose slow responses and performance issues during an incident using a systematic debugging checklist. It directs you to gather evidence, classify the error type, isolate the failing component, identify the root cause, and verify the remediation.

How do I fix connection pool exhaustion and async event-loop issues?▼

Fix connection pool exhaustion and async event-loop issues by applying targeted patterns for asynchronous environments. The skill provides specific tips to identify missing await calls, resolve event-loop blocking, and manage resource limits.

Can I use a structured checklist for resolving database and async runtime exceptions?▼

You can use a structured checklist for resolving database and async runtime exceptions. The workflow covers evidence gathering, error classification tables mapping symptoms to first-check actions, and remediation patterns for logging and retries.

Why do I need error classification tables for resolving production incidents?▼

Error classification tables are needed for resolving production incidents because they map observed symptoms directly to likely categories and first-check actions. This eliminates manual guesswork and accelerates root-cause identification.

What are the limitations of systematic debugging for production runtime errors?▼

Systematic debugging for production runtime errors requires existing log data to function effectively. It provides checklists and remediation patterns for known distributed and async scenarios, but may be limited by incomplete logging or novel, unclassified exceptions.