runbook-generator

Generate operational runbooks from architecture decisions and operational triggers.

Updated May 15, 2026
One-click install
npx skills add https://github.com/avgarcia/runcriticon --skill runbook-generator-avgarcia
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: runbook-generator
Source: https://github.com/avgarcia/runcriticon/tree/main/.claude/skills/runbook-generator
Command: npx skills add https://github.com/avgarcia/runcriticon --skill runbook-generator-avgarcia

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill reduces the effort and inconsistency involved in creating operational runbooks by turning architecture decisions and triggers into structured procedures that teams can execute safely.

Core Features & Use Cases

  • ADR-driven runbook creation: Generates operational documentation aligned with the project's Architecture Decision Records and runbook conventions.
  • Operational procedure templates: Produces sections for prerequisites, step-by-step procedures, verification, rollback, and execution logging.
  • Use Case: When a new secret rotation, disaster recovery process, security response procedure, or infrastructure operation is required, use this Skill to create the corresponding runbook document with the required governance details.

Quick Start

Use the runbook-generator skill to create a runbook for the required operational procedure named rotacion-session-signing-key.

Frequently Asked Questions about runbook-generator

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

FAQPage Schema
How do I create operational runbooks from architecture decision records?

Creating operational runbooks from architecture decision records (ADRs) involves mapping each architectural decision to structured procedures with prerequisites, step-by-step execution, verification, and rollback guidance. This ensures operational documentation remains maintainable and aligned with project governance.

What should be included in a disaster recovery or secret rotation runbook?

A disaster recovery or secret rotation runbook should include ADR traceability, prerequisite checks, step-by-step procedures, rollback guidance, verification steps, and execution logging. These structured sections ensure operations are executed safely and maintain compliance requirements.

How do I document rollback procedures and verification steps for infrastructure operations?

Documenting rollback procedures and verification steps for infrastructure operations requires generating structured templates that capture execution records and operational triggers. This guarantees that procedures for security response and compliance operations can be executed safely and reversed if necessary.

When do I need to generate an operational runbook for security response procedures?

You need to generate an operational runbook for security response procedures whenever a new architecture decision introduces operational triggers requiring structured execution. This applies to scenarios like infrastructure access, disaster recovery, and compliance operations where safe, documented execution is mandatory.

Can I use ADR traceability to maintain operational documentation for compliance operations?

Yes, using ADR traceability to maintain operational documentation for compliance operations ensures that every runbook step aligns with architectural decisions. This approach produces structured procedures with execution records and verification steps required for compliance auditing.