Runbook

Generate a standardized runbook document at docs/{serviceName}/runbook.md via guided Q&A.

1|Updated Jan 30, 2026
One-click install
npx skills add https://github.com/samdae/archflow --skill runbook-samdae
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Runbook
Source: https://github.com/samdae/archflow/tree/main/skills/runbook
Command: npx skills add https://github.com/samdae/archflow --skill runbook-samdae

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill collects deployment information through a guided Q&A and transforms it into a complete, shareable runbook document, reducing manual drafting effort and ensuring consistency.

Core Features & Use Cases

  • Guided data collection: Interactive prompts gather service name, environment details, build/deploy commands, and validations.
  • Structured output: Generates a standardized docs/{serviceName}/runbook.md with sections for service info, infrastructure, CI/CD, environments, and security notes.
  • Use Case: A team deploying a new microservice can quickly produce a ready-to-share runbook that engineers and operators can follow.

Quick Start

Launch the Runbook skill, answer the guided questions, and retrieve a ready-to-save docs/{serviceName}/runbook.md.

Frequently Asked Questions about Runbook

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

FAQPage Schema
How do I generate a deployment runbook for a microservice?

To generate a deployment runbook, launch this Skill and answer the guided Q&A prompts. It collects service details, CI/CD workflows, and environment configurations to output a standardized runbook document.

What is a standardized runbook document for CI/CD workflows?

A standardized runbook document provides repeatable, shareable operational guidance for multi-environment deployments. It includes service info, infrastructure, build steps, validation, monitoring, and security notes.

How are secrets handled when creating a runbook through guided Q&A?

Secrets are handled securely by ensuring they are never embedded directly in the generated runbook. The output document includes a dedicated security section for handling secrets safely during deployments.

Can I use this to document multi-environment deployment steps?

Yes, you can document multi-environment deployment steps. The guided Q&A collects environment details and generates a structured runbook covering build, deploy, validation, and monitoring steps across environments.

What is the best way to create shareable operational guidance for new services?

The best way to create shareable operational guidance is using an interactive Q&A process. It reduces manual drafting effort and ensures consistency by producing a ready-to-save markdown runbook for engineers.

Where is the generated runbook file saved?

The generated runbook file is saved as a markdown document at docs/{serviceName}/runbook.md. This structured output path ensures runbooks are organized by service name for easy retrieval.