runbook

Generate RUNBOOK.md with environment variables, health checks, failure fixes, and rollback steps.

Updated Apr 30, 2026
One-click install
npx skills add https://github.com/jnlanahan/Product-Agents-and-Skills --skill runbook-jnlanahan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: runbook
Source: https://github.com/jnlanahan/Product-Agents-and-Skills/tree/main/skills/6-Deploy-Runbook
Command: npx skills add https://github.com/jnlanahan/Product-Agents-and-Skills --skill runbook-jnlanahan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill prevents production downtime from turning into chaos by producing a single, accurate operational runbook for the currently deployed version.

Core Features & Use Cases

  • Post-deploy runbook generation: Creates an on-call reference after a successful production deploy so it reflects real deployed configuration rather than a plan.
  • Health checks and failure recovery: Documents the health endpoint behavior, common failure modes, first response steps, and how to fix them.
  • Rollback and verification guardrails: Includes rollback instructions and requires env var verification so the runbook is only considered complete when production is correctly configured.
  • Use case: After shipping a production SaaS, generate an on-call handoff document covering monitoring, required environment variables, alert response, and step-by-step rollback guidance.

Quick Start

Use the command /runbook to generate RUNBOOK.md at the project root for the current production deployment.

Frequently Asked Questions about runbook

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

FAQPage Schema
How do I generate an on-call runbook after a production deploy?

To generate an on-call runbook after a production deploy, run /runbook. It reads the codebase, deploy configuration, and health checks to produce RUNBOOK.md with verified environment variables, failure modes, alert response, and rollback steps.

What is a production runbook and what should it include for incident response?

A production runbook is an operational reference for incident response that should include health endpoint behavior, common failure modes with fixes, required environment variables, alert response guidance, and explicit rollback steps to reduce recovery time.

How do I document rollback steps and health checks for my deployed application?

Document rollback steps and health checks by reading the deployed codebase and configuration. The runbook generation process extracts health check implementation details and creates explicit rollback instructions based on the actual production deploy configuration.

Can I create an incident response runbook from my existing codebase and .env.example file?

Yes, you can create an incident response runbook by analyzing the existing codebase, deploy configuration, health check implementation, and .env.example file. This ensures the runbook reflects real deployed configuration with verified required environment variables.

Why do I need to verify environment variables when creating an on-call handoff document?

Verifying environment variables ensures the on-call runbook is only considered complete when production is correctly configured. This prevents first responders from encountering missing configuration during incidents and reduces downtime.

What is the best way to reduce recovery time during production incidents?

The best way to reduce recovery time is generating an operational runbook that answers first-responder questions during incidents. It provides alert response guidance, common failure modes with fixes, and explicit rollback steps based on the actual production deploy.