Runbook

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

1|Updated Jan 30, 2026

Search Tags:#automation #documentation #deployment #qa #ci-cd #runbook

Ready to run

npx skills add https://github.com/samdae/archflow --skill runbook-samdae

💬 Prompt for ChatGPT / Claude Chat▼

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.