← Back to Skills Marketplace
charlie-morrison

runbook-generator

by charlie-morrison · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
98
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install ops-runbook-generator
Description
Generate operational runbooks from project files. Scans Dockerfiles, docker-compose.yml, systemd units, Makefiles, package.json, and config files to produce...
Usage Guidance
This skill appears to do what it says: it scans project infrastructure files and produces runbooks using only Python stdlib. Before running or giving an agent access to it: 1) Review scripts/generate_runbook.py locally to confirm behavior (no network calls or subprocesses were seen in the visible code). 2) Run it on a copy of your repo or in an isolated environment, especially if the project contains production secrets — the script reads .env and systemd unit files (it attempts to mask .env values but still reads them). 3) If you plan to allow autonomous agent invocation, consider restricting which directories the agent can point it to and avoid exposing host-level/system directories. 4) If you need stronger guarantees, ask the owner for source provenance or audit the rest of the file (the provided file was truncated in the review text); absence of detected network calls in the shown code is reassuring, but verify the full file before trusting it with sensitive projects.
Capability Analysis
Type: OpenClaw Skill Name: ops-runbook-generator Version: 1.0.0 The skill is a legitimate utility for generating operational documentation by scanning project configuration files such as Dockerfiles, systemd units, and Makefiles. The core logic in `scripts/generate_runbook.py` uses only the Python standard library, performs no network requests, and executes no shell commands. Notably, the script includes privacy-conscious logic to mask sensitive values when scanning `.env` files, and no evidence of prompt injection or malicious intent was found.
Capability Assessment
Purpose & Capability
Name/description, SKILL.md, STATUS.md, and the included Python scanner are consistent: the tool scans Dockerfiles, docker-compose.yml, systemd units, Makefiles, package.json, .env, nginx.conf and generates runbooks. No unrelated binaries or credentials are requested.
Instruction Scope
The runtime instructions explicitly ask the agent/user to point the script at a project directory; the script reads many infrastructure files (including .env and systemd units). The script masks .env values in its extraction logic, but it still reads those files into memory. Avoid pointing the tool at directories containing production secrets or root/system config unless you trust the code and environment.
Install Mechanism
There is no install spec (instruction-only skill with a bundled Python script). That is low risk; nothing is downloaded or written to system locations by an installer.
Credentials
No environment variables, credentials, or config paths are declared or required. The script does scan .env files in project directories (which is expected for its purpose) and attempts to mask values in .env parsing.
Persistence & Privilege
always is false, the skill is user-invocable and can be autonomously invoked by the agent (default). It does not request permanent presence or modify other skills or system-wide agent settings.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install ops-runbook-generator
  3. After installation, invoke the skill by name or use /ops-runbook-generator
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release
Metadata
Slug ops-runbook-generator
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is runbook-generator?

Generate operational runbooks from project files. Scans Dockerfiles, docker-compose.yml, systemd units, Makefiles, package.json, and config files to produce... It is an AI Agent Skill for Claude Code / OpenClaw, with 98 downloads so far.

How do I install runbook-generator?

Run "/install ops-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 charlie-morrison (@charlie-morrison); the current version is v1.0.0.

💬 Comments