← Back to Skills Marketplace
Runbook Automator
by
charlie-morrison
· GitHub ↗
· v1.0.0
· MIT-0
37
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install runbook-automator
Description
Convert manual incident runbooks into automated, executable playbooks. Parse existing runbooks, generate scripts for each step, add health checks, rollback p...
Usage Guidance
This skill appears to do what it claims but contains several omissions and safety risks. Before installing or using it:
- Treat generated playbooks as potentially destructive: always review any generated script line-by-line before running, and prefer DRY_RUN=true for testing.
- Expect it to try to send notifications to Slack/PagerDuty if SLACK_WEBHOOK or PAGERDUTY_KEY are present in your environment — remove or isolate those env vars if you don't want test messages sent.
- The skill references external services (Confluence, Google Docs) but doesn't declare required credentials; verify how the agent would access those sources and don't provide credentials unless you trust the skill.
- Run the tool only in an isolated/test environment when first trying it; do not run on production hosts or with production credentials until you have validated generated scripts and rollback behavior.
- Ask the publisher (or request in the registry) that the skill declare required env vars, list the external commands it intends to call (kubectl, curl, bc, etc.), and add explicit safety checks (require explicit user confirmation before any non-dry-run execution, sandboxing, and detection of destructive commands).
- If you are uncomfortable with autonomous execution, restrict or disable automatic invocation for this skill in your agent configuration and require manual invocation/approval.
Capability Analysis
Type: OpenClaw Skill
Name: runbook-automator
Version: 1.0.0
The runbook-automator skill is designed to transform manual incident response documentation into executable bash scripts. It includes functionality for parsing text, auditing runbooks for gaps (using standard find/grep commands), and generating templates with built-in rollback and notification logic. The skill's behavior is transparent and aligns with its stated purpose, with no evidence of data exfiltration, malicious execution, or hidden prompt injection attacks.
Capability Assessment
Purpose & Capability
The name and description align with the instructions: parsing runbooks, classifying steps, generating scripts, auditing documents, and dry-running playbooks are coherent capabilities for a Runbook Automator. However, the SKILL.md references external systems (Slack, PagerDuty, Confluence, Google Docs) and runtime secrets (SLACK_WEBHOOK, PAGERDUTY_KEY) without declaring them in the skill metadata, which is an omission/incoherence between claimed capabilities and declared requirements.
Instruction Scope
The runtime instructions include generating executable scripts that may run arbitrary system commands (e.g., kubectl, DB failover commands), set trap-based rollbacks, and send notifications to external endpoints. The 'test' and 'convert' flows imply probing hosts and verifying credentials. There are no explicit safety guardrails described (for example, requiring an explicit user confirmation before executing a non-dry-run script, sandboxing, or automated checks for destructive operations). This gives the agent broad discretion to read repository files and potentially execute dangerous commands derived from runbooks.
Install Mechanism
This is an instruction-only skill with no install spec and no code files, so it does not write code to disk or pull external binaries. That minimizes install-time risk.
Credentials
The SKILL.md references environment variables and secrets (SLACK_WEBHOOK, PAGERDUTY_KEY, DRY_RUN) and external services (Slack, PagerDuty, Confluence, Google Docs) but the skill metadata lists no required env vars or credentials. This mismatch is problematic: the skill expects to use notification hooks and possibly credentials to reach hosts, yet does not declare them. A user could accidentally have their real webhooks/keys used if present in the environment, and there is no explicit guidance on what is required or how secrets are handled.
Persistence & Privilege
always is false and the skill is user-invocable. There is no install-time persistence or configuration of other skills. Autonomous invocation is allowed (the platform default) but not combined with other high-risk factors such as permanent presence or unsolicited configuration changes.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install runbook-automator - After installation, invoke the skill by name or use
/runbook-automator - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of runbook-automator.
- Converts manual incident runbooks into automated, executable playbooks.
- Parses existing runbooks to extract steps, health checks, rollback procedures, and notification hooks.
- Audits runbooks for missing verifications, rollback steps, and other gaps.
- Supports dry-run testing of generated playbooks to validate commands and dependencies.
- Provides structured templates for different incident types.
Metadata
Frequently Asked Questions
What is Runbook Automator?
Convert manual incident runbooks into automated, executable playbooks. Parse existing runbooks, generate scripts for each step, add health checks, rollback p... It is an AI Agent Skill for Claude Code / OpenClaw, with 37 downloads so far.
How do I install Runbook Automator?
Run "/install runbook-automator" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Runbook Automator free?
Yes, Runbook Automator is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Runbook Automator support?
Runbook Automator is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Runbook Automator?
It is built and maintained by charlie-morrison (@charlie-morrison); the current version is v1.0.0.
More Skills