debug

Triage production issues by interpreting logs, traces, and metrics.

7|Updated Jan 26, 2026
One-click install
npx skills add https://github.com/bricerising/enterprise-software-playbook --skill debug-bricerising
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debug
Source: https://github.com/bricerising/enterprise-software-playbook/tree/main/skills/debug
Command: npx skills add https://github.com/bricerising/enterprise-software-playbook --skill debug-bricerising

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Triage and diagnose production or local issues by following logs → traces → metrics to quickly identify symptoms and root causes.

Core Features & Use Cases

  • Structured triage workflow: Establish ground truth, collect evidence, map failure propagation, and decide mitigations.
  • Telemetry-driven analysis: Leverage logs, traces, and metrics across HTTP/gRPC services and async workers.
  • Guided playbooks and references: Access commands and scenario checklists in references to accelerate resolution.

Quick Start

Follow the triage workflow from the skill to triage a failing operation using the existing telemetry.

Frequently Asked Questions about debug

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

FAQPage Schema
How do I triage production issues using logs, traces, and metrics?

Triage production issues by interpreting logs, traces, and metrics to establish ground truth, gather evidence, map failure propagation, and decide on mitigations. This structured workflow identifies symptoms and potential root causes across HTTP/gRPC services and asynchronous workers.

What is the best way to diagnose 5xx errors and latency spikes in microservices?

Diagnose 5xx errors and latency spikes by following a telemetry-driven analysis workflow that maps failure propagation across HTTP/gRPC services. You establish ground truth, collect evidence from traces, and form hypotheses to decide on mitigations for SLO violations.

Do I need existing telemetry to debug production incidents?

Yes, existing telemetry is required to debug production incidents using this triage workflow. You need logs, traces, and metrics already in place to establish ground truth, gather evidence, and identify symptoms and potential root causes for errors and SLO violations.

Can I use this triage workflow for asynchronous workers and gRPC services?

Yes, you can use this triage workflow for asynchronous workers and gRPC services. The telemetry-driven analysis applies across HTTP/gRPC services and async workers to interpret logs, traces, and metrics for identifying symptoms and root causes of failures.

How do I identify root causes from observability data during an incident response?

Identify root causes from observability data by following a structured triage workflow to establish ground truth and gather evidence. You map failure propagation through logs, traces, and metrics to form hypotheses and decide on appropriate mitigations.

What are the limitations of telemetry-driven triage for local issues?

Telemetry-driven triage for local issues requires existing logs, traces, and metrics to function effectively. Without established telemetry, the structured workflow cannot establish ground truth or gather the evidence needed to identify symptoms and decide on mitigations.