Connect

Service Debugging Runbook

c0x12cbyc0x12c
•
78
•
API Development

Provides a structured framework for investigating and resolving production backend service issues, API failures, and performance bottlenecks.

The service-debugging skill transforms Claude into a systematic incident responder by providing a step-by-step diagnostic workflow for backend systems. It guides the investigation through symptom gathering, environment health checks, and targeted root-cause analysis using specialized grep and bash commands. By following this runbook, Claude can efficiently diagnose HTTP 4xx/5xx errors, performance degradation, and data inconsistencies, ensuring that fixes address the underlying cause rather than just hiding symptoms.

Key Features

01Comprehensive 'Gotchas' list to avoid common production debugging pitfalls
02Step-by-step diagnostic workflow from symptom gathering to verification
03Symptom-to-check mapping for rapid identification of HTTP errors
0478 GitHub stars
05Pre-configured health check commands for logs, database, and environment
06Root cause analysis techniques including git bisect and grep patterns

Use Cases

01Resolving environment-specific bugs that cannot be reproduced locally
02Diagnosing and fixing 500 Internal Server Errors in production APIs
03Investigating sudden service performance degradation or timeout issues