create-runbook

Generate markdown operational runbooks with deployment, incident, and maintenance sections.

6|Updated Feb 19, 2026
One-click install
npx skills add https://github.com/jerelvelarde/chalk-skills --skill create-runbook-jerelvelarde
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: create-runbook
Source: https://github.com/jerelvelarde/chalk-skills/tree/main/skills/create-runbook
Command: npx skills add https://github.com/jerelvelarde/chalk-skills --skill create-runbook-jerelvelarde

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Operators often need precise, repeatable runbooks during incidents or routine maintenance. This Skill automates the creation of structured operational runbooks that document procedures, escalation paths, verification steps, and rollback guidance, ensuring consistency under pressure.

Core Features & Use Cases

  • Step-by-step procedural templates with validation, verification, and rollback sections.
  • Built-in troubleshooting decision trees and escalation criteria for on-call responders.
  • Automatic placement of the final document in the engineering runbook repository with consistent naming.

Quick Start

Create a new runbook by specifying the service or process and scenario, then save it to .chalk/docs/engineering/<n>runbook<service>.md.

Frequently Asked Questions about create-runbook

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

FAQPage Schema
How do I create a production-ready runbook for on-call incident response?

A production runbook for on-call procedures documents step-by-step incident response, verification, rollback, and escalation paths. It ensures operators follow precise, repeatable actions under pressure during service disruptions or routine maintenance.

What should be included in an operational runbook for deployment and maintenance?

An operational runbook should include numbered deployment steps, validation checks, rollback guidance, troubleshooting decision trees, and escalation criteria. These structured sections ensure maintenance consistency and provide clear guidance for on-call responders during incidents.

How do I document rollback procedures and escalation paths for my services?

You document rollback procedures and escalation paths by using structured runbook templates. The skill guides you through capturing troubleshooting decision trees and escalation criteria, saving the final validated markdown to your engineering documentation repository.

Can I automatically generate ops documentation for incident management procedures?

Yes, you can automatically generate ops documentation for incident management. The skill outputs a validated markdown runbook with consistent naming conventions directly to your engineering docs folder, ensuring repeatable operational procedures across services.

Does this runbook generation tool work without external dependencies or components?

Yes, this runbook generation tool works without external dependencies or components. It uses built-in structured templates and validation checks to produce standalone markdown runbooks for your on-call procedures and maintenance tasks.