Runbook Generator

Turns operational knowledge into documented runbooks so you're not scrambling during an incident. You feed it context about your systems and it generates step-by-step procedures for common scenarios like deployments, rollbacks, or troubleshooting. Useful when you're building out ops documentation from scratch or trying to standardize how your team handles recurring issues. The real value is getting runbooks written at all, since most teams know they need them but never actually sit down to write them. Won't replace deep system knowledge, but it'll give you a solid starting template that you can refine based on what actually breaks.

skills.sh installs: 614
GitHub stars: 29.5K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add alirezarezvani/claude-skills --skill runbook-generator --agent claude-code

Installs into .claude/skills of the current project.

Files

Runbook Generator

Tier: POWERFUL
Category: Engineering
Domain: DevOps / Site Reliability Engineering

Overview

Generate operational runbooks quickly from a service name, then customize for deployment, incident response, maintenance, and rollback workflows.

Core Capabilities

Runbook skeleton generation from a CLI
Standard sections for start/stop/health/rollback
Structured escalation and incident handling placeholders
Reference templates for deployment and incident playbooks

When to Use

A service has no runbook and needs a baseline immediately
Existing runbooks are inconsistent across teams
On-call onboarding requires standardized operations docs
You need repeatable runbook scaffolding for new services

Quick Start

# Print runbook to stdout
python3 scripts/runbook_generator.py payments-api

# Write runbook file
python3 scripts/runbook_generator.py payments-api --owner platform --output docs/runbooks/payments-api.md