runbook

Create structured operational runbooks with prerequisites, verification, troubleshooting, rollback, and escalation.

Updated Apr 8, 2026
One-click install
npx skills add https://github.com/sun2443/designer-skills --skill runbook-sun2443
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: runbook
Source: https://github.com/sun2443/designer-skills/tree/main/operations/skills/runbook
Command: npx skills add https://github.com/sun2443/designer-skills --skill runbook-sun2443

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you document recurring operational procedures so on-call and ops teams can execute them consistently, safely, and quickly, even when knowledge is not shared or is scattered.

Core Features & Use Cases

  • Step-by-step runbook creation: Produces an operational checklist with clear commands, expected results, and failure handling for a specific recurring task.
  • Operational structure for confidence: Includes prerequisites, verification, troubleshooting, rollback, escalation paths, and a history section to track updates and outcomes.
  • Connector-aware guidance: Encourages updating existing runbooks and linking to ops tooling when connectors (like a knowledge base or ITSM system) are available.

Quick Start

Tell the AI: Create a runbook for "database failover" that includes prerequisites, exact verification steps, troubleshooting symptoms, rollback procedure, and escalation contacts.

Frequently Asked Questions about runbook

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

FAQPage Schema
How do I document recurring operations tasks into repeatable steps?▼

You document recurring operations tasks by generating a structured runbook that converts tribal knowledge into step-by-step procedures, prerequisites, and verification checks. This ensures on-call teams execute operational workflows consistently and safely.

What should an incident response runbook include for on-call escalation?▼

An incident response runbook should include structured step-by-step procedures, exact verification steps, troubleshooting symptoms, rollback procedures, and escalation contacts. This structure provides clear decision paths for handling operational failures during on-call duties.

How do I create a rollback procedure for an operations workflow?▼

You create a rollback procedure for an operations workflow by parameterizing the target process within a runbook template. The generated document outlines specific rollback steps alongside prerequisites and troubleshooting actions to safely revert changes.

Does the runbook template support integration with existing ITSM systems?▼

Yes, the runbook template supports integration with existing ITSM systems. When connectors like a knowledge base or ITSM tooling are available, it provides connector-aware guidance to update existing runbooks and link directly to your operations tooling.

What is the best way to structure tribal knowledge for on-call engineers?▼

The best way to structure tribal knowledge for on-call engineers is using an operational runbook format with YAML frontmatter. This format parameterizes target processes into clear commands, expected results, and failure handling paths for consistent execution.

Can I parameterize a database failover process in an operational runbook?▼

Yes, you can parameterize a database failover process in an operational runbook. By providing the target process as an argument, the template generates a customized checklist with prerequisites, troubleshooting, and rollback steps for that specific task.