runbook-generator

Generate structured Markdown incident runbooks from alerts and incident classes.

1|Updated Apr 16, 2026
One-click install
npx skills add https://github.com/FrogAi/Xenopus --skill runbook-generator-frogai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: runbook-generator
Source: https://github.com/FrogAi/Xenopus/tree/main/Gemini/Skills/Gemini%203.1%20Pro/runbook-generator
Command: npx skills add https://github.com/FrogAi/Xenopus --skill runbook-generator-frogai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Incident response often suffers from vague runbooks that slow responders. The runbook-generator produces precise, ready-to-follow runbooks tailored to the exact alert or incident class, service context, and observability stack.

Core Features & Use Cases

  • Live-reference-driven runbooks: fetches up-to-date incident-response references and runbook practices.
  • Decision-tree diagnosis: builds a branching verification path with explicit commands and expected outputs.
  • Structured output: Markdown runbook plus optional automation stubs for Rundeck/StackStorm/Ansible.
  • Validation and de-escalation: includes validation steps and clear criteria to de-escalate when resolved.
  • Repeatable templates: supports consistent runbook formats across incidents.

Quick Start

Provide the alert name, service, and observability context to generate a complete incident runbook.

Frequently Asked Questions about runbook-generator

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

FAQPage Schema
How do I auto-generate incident runbooks from alerts?

To auto-generate incident runbooks from alerts, provide the alert name, service, and observability context. The tool produces a structured Markdown runbook with specific commands, dashboards, and queries, plus an optional automation stub for Rundeck, StackStorm, or Ansible.

What is a decision-tree diagnosis in incident response?

A decision-tree diagnosis builds a branching verification path for incident response with explicit commands and expected outputs. It guides on-call responders through structured troubleshooting steps, ensuring commands, dashboards, and queries are specific and validated against live references.

Can I create automation stubs for Ansible or StackStorm from an incident runbook?

Yes, you can create automation stubs for Rundeck, StackStorm, or Ansible directly from the generated incident runbook. The tool outputs a structured Markdown runbook alongside an optional automation stub to streamline on-call response and remediation actions.

How do I ensure my incident runbook has specific commands and validation steps?

To ensure incident runbooks have specific commands and validation steps, the generator applies live references and a verifiable output contract. It builds a decision-tree diagnosis with clear validation steps, traceable sources, and explicit criteria to de-escalate when the incident is resolved.

What's the best way to standardize incident response runbooks across services?

The best way to standardize incident response runbooks across services is using repeatable templates driven by live references. This ensures consistent runbook formats across incidents, tailored to the exact alert, service context, and observability stack for precise on-call execution.

Do I need observability data to generate an SRE runbook?

Yes, you need observability data to generate an SRE runbook. Providing the alert name, service, and observability context is required to produce a production-ready incident runbook with specific commands, dashboards, queries, and escalation paths.