← Back to Skills Marketplace
runbook-generator
by
Alireza Rezvani
· GitHub ↗
· v1.0.0
· MIT-0
354
Downloads
0
Stars
4
Active Installs
2
Versions
Install in OpenClaw
/install runbook-generator
Description
Runbook Generator
Usage Guidance
This skill appears to do what it says (generate runbooks from a repo), but its runtime instructions assume access to repository files, various CLIs (git, jq, psql, prisma, vercel), and sensitive environment variables (production/staging DB URLs, test tokens, PagerDuty/Slack contacts) that are NOT declared. Before installing or enabling it: (1) do NOT provide production credentials to the skill; test only on a copy of the repo or in staging; (2) require explicit human approval before any command that can change state (migrations, resets, rollbacks); (3) restrict agent autonomy (disable automatic execution of destructive steps) or add a confirmation/approval step in the workflow; (4) ensure the runtime environment has the necessary CLIs if you intend to use the command examples, or treat the outputs as templates for a human to execute; (5) consider asking the skill author to declare required env vars and binaries and to add non-destructive dry-run defaults. If you need absolute safety, avoid giving the agent any secrets and only use it for read-only analysis and draft runbook generation.
Capability Analysis
Type: OpenClaw Skill
Name: runbook-generator
Version: 1.0.0
The 'runbook-generator' skill is designed to analyze a codebase and generate operational documentation. It uses standard shell commands (ls, grep, cat, jq) to detect the technology stack and provides templates for deployment, incident response, and database maintenance. There is no evidence of data exfiltration, malicious execution, or prompt injection; all commands and instructions are consistent with its stated purpose of DevOps automation and documentation.
Capability Assessment
Purpose & Capability
The name/description (runbook generator) matches the instructions: scanning a codebase, detecting stack components, and producing runbooks. The kinds of checks and templates (deployment, incident response, DB maintenance) are consistent with the stated goal.
Instruction Scope
SKILL.md instructs scanning repository files (ls, grep, git log) which is expected, but also includes concrete shell commands that assume access to credentials and runtime tools (psql, npx prisma, vercel CLI, curl with TEST_TOKEN). It includes potentially destructive operations (prisma migrate reset) and production rollbacks without explicit safeguards or confirmation steps. The guidance gives agents broad discretion to run admin commands that could modify production state.
Install Mechanism
Instruction-only skill with no install spec or downloaded artifacts, which is low risk from an installation perspective.
Credentials
SKILL.md references many credential-like environment variables and tokens (DATABASE_URL, STAGING_DATABASE_URL, PROD_DATABASE_URL, TEST_TOKEN, PagerDuty/Slack contacts) but the skill declares no required env vars. It also assumes availability of CLIs and access to production secrets. Requesting or using production credentials is disproportionate for an automatically invoked agent unless explicit human approval and least-privilege controls are in place.
Persistence & Privilege
The skill is not always-enabled and uses normal autonomous invocation defaults. It does not request permanent platform-wide presence or modify other skills. However, autonomous invocation combined with the instruction issues above increases risk, so consider limiting autonomy or requiring human confirmation before executing commands.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install runbook-generator - After installation, invoke the skill by name or use
/runbook-generator - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial publish
v2.1.1
v2.1.1: optimization, reference splits
Metadata
Frequently Asked Questions
What is runbook-generator?
Runbook Generator. It is an AI Agent Skill for Claude Code / OpenClaw, with 354 downloads so far.
How do I install runbook-generator?
Run "/install runbook-generator" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is runbook-generator free?
Yes, runbook-generator is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does runbook-generator support?
runbook-generator is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created runbook-generator?
It is built and maintained by Alireza Rezvani (@alirezarezvani); the current version is v1.0.0.
More Skills