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.