runbook-generator
Generates comprehensive operational runbooks for any system or process. Reads codebase, infrastructure config, and deployment scripts to produce structured runbook.md files formatted for on-call engineers. Use when you need operations documentation, incident response guides, deployment procedures, or disaster recovery plans.
How do I install this agent skill?
npx skills add https://github.com/onewave-ai/claude-skills --skill runbook-generatorIs this agent skill safe to install?
- Gen Agent Trust Hubpass
This skill acts as an automated operations runbook generator. It explores the workspace repository using standard file glob and grep patterns to find infrastructure configurations, CI/CD pipelines, and health checkpoints, then builds a structured, comprehensive markdown runbook. No security violations or dangerous practices were detected.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
Runbook Generator
Generate a comprehensive operational runbook.md from a system's codebase, infrastructure config, and deployment scripts -- written for on-call engineers working incidents, deployments, and routine operations at 3am.
Contents
references/discovery-patterns.md-- Glob/Grep patterns and config files to inspect during discovery.references/output-template.md-- The full 9-section runbook.md structure to populate.references/writing-style.md-- Clarity, urgency, completeness, formatting, and accuracy rules plus output requirements.
Workflow
- Discover the system. Run the Glob patterns in
references/discovery-patterns.md(Step 1) to identify the stack and infrastructure. - Read key configuration. Open and analyze the config files listed in
references/discovery-patterns.md(Step 2): IaC, containers, CI/CD, app config, deploy scripts, monitoring, migrations, load balancers, docs. - Identify operational behavior. Run the Grep patterns in
references/discovery-patterns.md(Step 3) to surface health checks, metrics, caching, jobs, migrations, rollback, scaling, backups, TLS, secrets, alerting, and more. - Generate the runbook. Produce
runbook.mdfollowing the structure inreferences/output-template.md. Cover all 9 sections; adapt content to what discovery found; never include purely speculative sections. - Apply writing standards. Follow every rule in
references/writing-style.md-- copy-pasteable commands, expected outputs, sequential steps, P1-first ordering, tables for structured data, and the accuracy rules. - Verify and flag gaps. Confirm referenced paths and scripts exist. Mark unverifiable details with
[VERIFY]and missing sections with[ACTION REQUIRED]: ...so the runbook doubles as a gap analysis.
Output
Write runbook.md to the project root (or a directory the user specifies). It must be 500+ lines, cover all 9 sections, contain real commands derived from the codebase, include at least one architecture diagram, carry a complete table of contents, and never fabricate infrastructure details. See references/writing-style.md for the full output checklist.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/onewave-ai/claude-skills/runbook-generator">View runbook-generator on skillZs</a>