runbook-gen

Generate SRE runbooks and blameless post-mortems with severity classification and escalation paths.

110|14|Updated May 12, 2026
One-click install
npx skills add https://github.com/EliasOulkadi/shokunin --skill runbook-gen
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: runbook-gen
Source: https://github.com/EliasOulkadi/shokunin/tree/main/.pack/skills/runbook-gen
Command: npx skills add https://github.com/EliasOulkadi/shokunin --skill runbook-gen

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It removes the scramble during incidents by producing clear, time-boxed SRE runbooks and structured blameless post-mortems that on-call engineers can execute immediately.

Core Features & Use Cases

  • Severity classification & escalation: Applies an SRE severity matrix to set response SLAs and creates escalation paths (primary, secondary, EM, VP).
  • Operational runbook authoring: Generates a detection/diagnosis/resolution/verification runbook with decision-tree guidance and copy-paste-friendly command placeholders.
  • War room & communications templates: Produces war-room setup guidance (Slack/Zoom, status page updates, customer comms) and incident timeline structure.
  • Blameless post-mortem with action items: Generates an SRE-aligned post-mortem template focusing on system/process causes and tracked follow-ups.

Quick Start

Use the runbook-gen skill to generate an outage playbook for a Sev2 degraded-performance incident including a severity matrix, diagnosis decision tree, war room setup, verification checklist, and a blameless post-mortem template.

Frequently Asked Questions about runbook-gen

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

FAQPage Schema
How do I generate an SRE runbook for incident response?

To generate an SRE runbook for incident response, you can use this skill to produce operational templates that structure severity classification, time-boxed diagnosis, resolution steps, and escalation paths for on-call procedures.

What is a blameless post-mortem and how do I structure one?

A blameless post-mortem focuses on system and process causes rather than individual blame. This skill generates a structured post-mortem template with an incident timeline, verification checklists, and tracked action items.

How do I set up a war room and status page updates during an outage?

To set up a war room during an outage, this skill provides templates for war-room setup, customer communications, and incident timeline documentation, ensuring coordinated response across Slack, Zoom, and status page updates.

Can I create an escalation matrix for different severity levels?

Yes, you can create an escalation matrix for different severity levels. The skill applies an SRE severity matrix to set response SLAs and defines escalation paths across primary, secondary, engineering manager, and VP contacts.

What should be included in an operational runbook for a degraded-performance incident?

An operational runbook for a degraded-performance incident should include a detection and diagnosis decision tree, resolution steps, copy-paste-friendly command placeholders, and a verification checklist to confirm system recovery.

Are there limitations on using automated runbook generation for customer communications?

Automated runbook generation for customer communications follows defined negative-use boundaries to prevent inappropriate outputs. It produces SRE-aligned guidance and templates but requires human review before sending external status page updates.