sd-runbook

Generates source-traceable operational runbooks with validation states, failure handling, and rollback contracts.

Updated Jun 26, 2026
One-click install
npx skills add https://github.com/platypeeps/sd-ai-command-pack --skill sd-runbook-platypeeps
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: sd-runbook
Source: https://github.com/platypeeps/sd-ai-command-pack/tree/main/contrib/sd-runbook
Command: npx skills add https://github.com/platypeeps/sd-ai-command-pack --skill sd-runbook-platypeeps

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Operational procedures often live in scattered tickets, logs, and stale documents, making it risky to execute maintenance, recovery, or migration events without a verified, step-by-step plan. This Skill converts validated operational knowledge into a bounded, versioned runbook where every mutating step carries its authority, target, verification, and failure handling. ## Core Features & Use Cases - Step-level execution states: Every step is labeled validated, partially-validated, or proposed, bound to evidence, environment, version, and date. - Safety gates and failure modeling: Preflight checks, abort criteria, decision points, partial-failure reconciliation, and distinct rollback versus recovery paths. - Secret and target hygiene: Credentials become named placeholders, and destructive or broad targets are defensively validated before inclusion. - Use Case: An operator preparing a database migration asks for a runbook covering preflight backups, staged mutations, verification queries, and an escalation path, with untested steps clearly flagged rather than presented as proven. ## Quick Start Use the sd-runbook skill to create a runbook for procedure=database failover with trigger=primary node unreachable and environment=production cluster, marking any untested recovery steps as proposed.

Frequently Asked Questions about sd-runbook

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

FAQPage Schema
How do I create an operational runbook from existing procedures and logs?▼

Supply the procedure, trigger, environment, authority, and sources as arguments, and the Skill inventories every source before drafting steps. Each step gets a stable ID, execution state, verification, failure handling, and evidence locator.

What is the difference between a runbook, a checklist, and an SOP?▼

A runbook covers a bounded operational event with decision points and failure response. Use a checklist for compact point-of-work verification and an SOP for routine policy-oriented procedures; this Skill states the boundary rather than absorbing those workflows.

Can the runbook execute the commands it contains?▼

No, the Skill is read-only and never executes commands, mutates systems, approves changes, or publishes the runbook. Execution requires a separate explicit request, current-state revalidation, and the relevant authorized capability.

How are untested or stale procedure steps handled?▼

Steps are labeled validated, partially-validated, or proposed, with validation bound to environment, version, date, and evidence. Stale or unsupported material triggers a prominent warning instead of being presented as operational truth.

How does the runbook handle secrets and destructive targets?▼

Credentials and identifiers are replaced with named placeholders plus an authorized retrieval method. Destructive commands require the operator to resolve and display the exact target, rejecting empty variables, traversal, and root or workspace-wide scope.

What happens when a runbook step fails partway through?▼

The Skill models partial failure explicitly by capturing the last verified state, completed and failed step IDs, side effects, and uncertain state. Live state must be reconciled before any retry, rollback, or recovery, and rollback is kept distinct from recovery.