runbook

Investigate production symptoms and generate structured incident reports from logs, metrics, and traces.

5|Updated Mar 9, 2026
One-click install
npx skills add https://github.com/rbah31/claude-code-workflow --skill runbook-rbah31
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: runbook
Source: https://github.com/rbah31/claude-code-workflow/tree/main/.claude/skills/runbook
Command: npx skills add https://github.com/rbah31/claude-code-workflow --skill runbook-rbah31

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The Runbook helps engineers systematically investigate production issues, moving from symptom to a structured incident report and enabling consistent post-incident learning.

Core Features & Use Cases

  • Structured investigation approach: Start from symptom, gather evidence, and isolate root cause without guessing.
  • Reference-guided and general playbooks: Use existing references when available or fall back to a general method to ensure repeatable results.
  • Documentation and learning: Produce incident reports and save new playbooks for future incidents.

Quick Start

Document the symptom and begin the investigation using logs and metrics to generate a structured incident report.

Frequently Asked Questions about runbook

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

FAQPage Schema
How do I investigate production incidents to find the root cause?

Investigating production incidents involves identifying symptoms, applying a matching or general playbook, gathering evidence across logs, metrics, and traces, and documenting the root cause in a structured incident report.

What is the best way to structure an incident report for production logs and metrics?

Structuring an incident report requires following a standardized template that captures symptoms, evidence from logs and metrics, root-cause analysis, and saves new playbooks for future reuse.

How do I create a reusable playbook for incident response?

Creating a reusable playbook requires applying a general investigation path to pinpoint the root cause, then saving the successful steps as a new playbook to references for future incidents.

Can I use existing references to investigate production issues instead of starting from scratch?

Yes, you can use existing reference playbooks to investigate production issues. The system applies a matching playbook when available, or falls back to a general investigation path to ensure repeatable results.

How do I gather evidence across logs, metrics, and traces during an incident?

Gathering evidence across logs, metrics, and traces requires identifying the production symptom and scope first, then following a structured investigation path to pinpoint the root cause and document the findings.

Why should I document production incidents using a structured playbook approach?

Documenting production incidents using a structured playbook approach ensures consistent post-incident learning, moves systematically from symptom to root cause without guessing, and enables repeatable results for future issues.