---
name: devops-runbooks
description: Operational runbook and procedure documentation specialist. Use when
  creating incident response procedures, operational playbooks, or system maintenance
  guides.
author: Joseph OBrien
status: unpublished
updated: '2025-12-23'
version: 1.0.1
tag: skill
type: skill
---

# DevOps Runbooks Skill

Creates actionable runbooks for operational procedures, incident response, and system maintenance.

## What This Skill Does

- Creates operational runbooks
- Documents incident procedures
- Defines escalation paths
- Provides troubleshooting guides
- Documents rollback procedures
- Captures operational knowledge

## When to Use

- Incident response planning
- On-call documentation
- System maintenance procedures
- Disaster recovery planning
- Knowledge transfer

## Reference Files

- `references/RUNBOOK.template.md` - Comprehensive operational runbook format

## Runbook Structure

1. **Overview** - Purpose and when to use
2. **Prerequisites** - Access and tools needed
3. **Quick Reference** - Key commands and URLs
4. **Procedure** - Step-by-step with verification
5. **Rollback** - How to revert changes
6. **Troubleshooting** - Common issues
7. **Escalation** - When and how to escalate

## Best Practices

- Commands must be copy-pasteable
- Include expected output for each step
- Document decision points clearly
- Define rollback at each step
- Keep procedures current (test regularly)
- Include escalation contacts