# Create Reliable DevOps Runbooks

Operational knowledge often lives in tickets, chat, and memory. This skill turns procedures into structured runbooks for incidents, maintenance, rollback, and escalation.

## Install

```bash
npx skillstore add joseph obrien/89jobrien-devops-runbooks
```

## Metadata

- Status: approved
- Slug: 89jobrien-devops-runbooks
- Version: 1.0.1
- Author version: 1.0.1
- Skillstore revision: r1
- Version status: valid
- Tree hash: 6dc922cb1bd12962f55845628dfee94b7a767f0c1d3e55348c2241c8664c1b2b
- Author: Joseph OBrien
- GitHub username: 89jobrien
- License: MIT
- Repository: https://github.com/89jobrien/steve/tree/main/steve/skills/devops-runbooks
- Ref: c4037264bbd363c572662d6154a3ab28f5ca4f53
- Supported tools: Claude, Codex, Claude Code
- Audit status: complete
- Agent install advisory: allowed
- Manual install advisory: allowed
- Artifact signature: available
- Audit attestation: unavailable
- Human verification: not\_verified
- Risk factors: external\_commands
- Quality score: 79
- Quality tier: bronze
- Public page: https://skillstore.pages.dev/skills/89jobrien-devops-runbooks
- Manifest: https://skillstore.pages.dev/api/skills/89jobrien-devops-runbooks/manifest

## Capabilities

- Creates runbooks with overview, prerequisites, quick reference, procedure, verification, rollback, troubleshooting, and escalation sections.
- Defines access needs, required tools, credentials locations, key commands, URLs, and contacts.
- Documents step-by-step procedures with expected output and verification checks.
- Adds rollback steps and rollback verification for failed changes.
- Captures troubleshooting scenarios, symptoms, causes, and resolutions.
- Builds escalation paths and incident handoff templates.

## Use Cases

- Prepare On-Call Procedures: Create a clear incident response runbook for alerts, triage, verification, rollback, and escalation.
- Document Maintenance Tasks: Turn recurring maintenance work into repeatable steps with prerequisites, commands, expected output, and checks.
- Capture Team Knowledge: Convert informal operational knowledge into a shared runbook for handoffs, training, and service ownership.

## Prompt Templates

### Create a Basic Runbook

```
Create a runbook for restarting SERVICE_NAME. Include prerequisites, commands, expected output, verification, rollback, and escalation.
```

### Build an Incident Playbook

```
Create a P1 incident runbook for API latency. Include triage steps, dashboards, log checks, customer impact, decision points, and escalation.
```

### Add Rollback and Validation

```
Improve this deployment procedure with rollback steps, verification commands, success criteria, failure handling, and expected outputs for each step.
```

### Standardize Multiple Runbooks

```
Review these runbook notes and convert them into a consistent operational format. Identify missing prerequisites, contacts, commands, and test evidence.
```

## Limitations

- It does not execute commands or validate live infrastructure state.
- It needs accurate service names, contacts, access paths, and command examples from the user.
- It cannot verify credentials, permissions, or dashboard URLs.
- Generated procedures require review and testing before production use.

## Best Practices

- Provide real service names, ownership details, and trusted command examples.
- Test every procedure in a safe environment before production use.
- Keep rollback, verification, and escalation sections updated after incidents.

## Anti Patterns

- Do not publish commands that nobody has reviewed or tested.
- Do not store secrets directly in a runbook.
- Do not leave escalation contacts, dashboards, or credential paths as vague placeholders.

## Security Audit

- Audited at: 2026-07-05T12:03:30.222\+00:00
- Summary: The flagged RUNBOOK.template.md entries are benign placeholders for operational systems, not attempts to target the model system prompt. The SKILL.md backtick finding is inline Markdown around a reference path, not Ruby or shell execution. No semantic prompt injection, data exfiltration intent, or hidden command execution was found.

## Stats

- Views: 167
- Downloads: 15
- Favorites: 0
- Popularity score: 0