Oncall runbook executor
Skill sisodiabhumca/agent-skills/skills/oncall-runbook-executor
Production-Ready Agent Skills : product analytics, growth experiments, CRM, research synthesis, postmortems, data contracts, SaaS spend, compliance, architecture maps, and LLM eval and many more.
npx -y skills add sisodiabhumca/agent-skills --skill oncall-runbook-executorAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its author says it does
Copied from the file, not written here
Use during an incident or routine on-call task to execute a YAML-defined runbook step by step. Each step has a description, an optional precheck command, the action command, and an expected outcome. Produces a tamper-evident execution log. Vendor-neutral; works with any shell-capable agent runtime.
SKILL.md
2.3 KB, as published. Nobody here has run it
On-Call Runbook Executor
When to invoke
- "Run the database failover runbook."
- "Walk me through the certificate rotation playbook."
- "Execute the deploy rollback steps."
Inputs needed
- Runbook YAML — see schema below.
- Mode —
dry-run(default; prints commands) orexecute(runs them). - Approval prompts — interactive
--confirmprompt before each action by default.
Runbook schema
name: deploy-rollback
description: Roll back the most recent deploy of svc-checkout
owner: sre-oncall
prechecks:
- desc: kubectl is configured
cmd: kubectl version --client --output=yaml
steps:
- id: identify_revision
desc: Identify the previous revision
cmd: kubectl rollout history deploy/svc-checkout | tail -3
expect_zero_exit: true
- id: rollback
desc: Roll back to the previous revision
cmd: kubectl rollout undo deploy/svc-checkout
requires_confirm: true
- id: verify
desc: Wait for rollout to complete
cmd: kubectl rollout status deploy/svc-checkout --timeout=120s
expect_zero_exit: true
postchecks:
- desc: 5xx is back to baseline
cmd: ./scripts/check_5xx.sh
Workflow
- Load the runbook YAML.
- Run prechecks — abort if any precheck fails.
- For each step:
- Print step description and command.
- In
executemode and ifrequires_confirm, prompt the operator. - Run command, capture stdout/stderr/exit.
- Compare to expectation; mark pass/fail.
- Run postchecks.
- Emit a Markdown execution log (timestamps, exit codes, outputs).
Guardrails
- Default mode is
dry-run; require an explicit--mode executeto run anything. - Steps with
requires_confirm: truemust prompt unless--yesis set. - Never auto-skip a failed precheck — abort and surface clearly.
- Truncate captured output to a configurable max bytes per step.
Reference code
runbook.py reads YAML, executes locally, and writes a Markdown log.