89jobrien

devops-runbooks

Operational runbook and procedure documentation specialist. Use when

89jobrien 4 Updated 8mo ago

Resources

1
GitHub

Install

npx skillscat add 89jobrien/steve/devops-runbooks

Install via the SkillsCat registry.

About this skill

We need to produce a 2-3 sentence plain-text summary, objective, factual, no marketing language, no superlatives, no calls to action, natural prose, no bullet points, no headings, no markdown formatting. At most 60 words. Must be only the summary text, no extra. So produce maybe 2-3 sentences, within 60 words. Let's craft: "The skill generates operational runbooks and incident response procedures that document step‑by‑step processes, verification, rollback, and escalation paths.

SKILL.md

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