# Operational runbooks (/observability--runbook-gen)

/observability--runbook-gen is a Claude Code skill in the Code section. Generates runbooks by reading your code and infrastructure, with symptoms, diagnosis commands, remediation ordered by safety, and escalation.

- Web version: https://skills.sgomez.dev/en/s/observability--runbook-gen
- Section: [Code](https://skills.sgomez.dev/en/code.md)
- Author: Santiago Gómez de la Torre
- License: MIT
- Source: https://github.com/sgomez-dev/claude-skills/blob/main/skills/observability/runbook-gen.md
- Updated 10 Jul 2026

## How to ask for it

- `/observability--runbook-gen create a runbook for when the message queue backs up`
- `/observability--runbook-gen document how to diagnose a spike in 500 errors`
- `/observability--runbook-gen generate the runbook for restoring the database`

## Install

macOS · Linux:

```
curl -fsSL https://raw.githubusercontent.com/sgomez-dev/claude-skills/main/install.sh | bash
```

Windows:

```
irm https://raw.githubusercontent.com/sgomez-dev/claude-skills/main/install.ps1 | iex
```

Claude Code plugin:

```
/plugin marketplace add sgomez-dev/claude-skills
/plugin install observability-skills@claude-skills-collection
```

## Permissions

- Reads: `**/*`
- Writes: `docs/**`, `**/*.md`
- Runs: —
- Network: No
- Destructive: No

## Author's description

Generate operational runbooks covering symptoms, diagnosis, and remediation

- [How we review this](https://skills.sgomez.dev/en/methodology.md)