On-Call Runbook Skill

Produce a complete on-call runbook for a service — giving the on-call engineer everything they need to respond confidently to alerts at 3am, without having to ask anyone for help.

A good on-call runbook reduces mean time to resolution (MTTR) by eliminating the "what do I do first?" problem. It is written for the on-call engineer who has just been paged and needs to act, not for someone calmly reading documentation.

Required Inputs

Ask for these if not already provided:

• Service name and what it does
• Team and tech lead name
• Alert list — names of alerts that currently page on-call
• Monitoring setup — Datadog / Grafana / CloudWatch / PagerDuty / etc.
• Common failure modes — what breaks most often, and what fixes it
• Escalation contacts — who to call when on-call can't resolve it
• Deployment setup — can on-call roll back? How?
• Service dependencies — what does this service depend on, and what depends on it?

Output Format