How do I install the Ops Runbook skill?

Run npx skillmds@latest add evolution-foundation/ops-runbook in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Ops Runbook safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Ops Runbook?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Ops Runbook free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Ops Runbook?

evolution-foundation (@evolution-foundation) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Ops Runbook by evolution-foundation

Name: Ops Runbook
Author: evolution-foundation

Ops Runbook

Criar ou atualizar runbook operacional para tarefa ou procedimento recorrente. Use quando documentar tarefa que o time de ops precisa rodar repetidamente, transformar conhecimento tribal em comandos passo a passo, adicionar troubleshooting e rollback a procedimento existente, ou escrever caminhos de escalação para quando algo der errado. Agente Clawdia.

File contents

/ops-runbook

Se encontrar placeholders desconhecidos ou precisar verificar quais ferramentas estão conectadas, consulte CONNECTORS.md.

Cria runbook operacional passo a passo para tarefa ou procedimento recorrente.

Agente

Clawdia — hub operacional, calendário, emails, tarefas, decisões.

Output

## Runbook: [Nome da Tarefa]
**Responsável:** [Time/Pessoa] | **Frequência:** [Diária/Semanal/Mensal/Conforme Necessário]
**Última Atualização:** [Data] | **Última Execução:** [Data]

### Objetivo
[O que esse runbook realiza e quando usar]

### Pré-requisitos
- [ ] [Acesso ou permissão necessária]
- [ ] [Ferramenta ou sistema necessário]
- [ ] [Dado ou input necessário]

### Procedimento

#### Etapa 1: [Nome]
```
[Comando exato, ação ou instrução]
```
**Resultado esperado:** [O que deve acontecer]
**Se falhar:** [O que fazer]

#### Etapa 2: [Nome]
```
[Comando exato, ação ou instrução]
```
**Resultado esperado:** [O que deve acontecer]
**Se falhar:** [O que fazer]

### Verificação
- [ ] [Como confirmar que a tarefa foi concluída com sucesso]
- [ ] [O que checar]

### Troubleshooting
| Sintoma | Causa Provável | Solução |
|---------|---------------|---------|
| [O que você vê] | [Por quê] | [O que fazer] |

### Rollback
[Como desfazer isso se algo der errado]

### Escalação
| Situação | Contato | Método |
|----------|---------|--------|
| [Quando escalar] | [Quem] | [Como contatar — Discord/WhatsApp/telefone] |

### Histórico
| Data | Executado por | Notas |
|------|--------------|-------|
| [Data] | [Pessoa] | [Issues ou observações] |

Se Conectores Disponíveis

Se Notion MCP estiver conectado:

Buscar runbooks existentes para atualizar em vez de criar do zero
Publicar o runbook finalizado na wiki de ops do Notion

Se Linear MCP estiver conectado:

Vincular o runbook a tipos de incident e change requests relacionados
Referenciar issues de manutenção recorrentes

Dicas

Seja dolorosamente específico — "Rodar o script" não é uma etapa. "Rodar python sync.py --prod --dry-run no servidor de ops" é.
Inclua modos de falha — O que pode dar errado em cada etapa e o que fazer a respeito.
Teste o runbook — Peça a alguém não familiarizado com o processo para segui-lo. Corrija onde travarem.

---name: ops-runbookdescription: Criar ou atualizar runbook operacional para tarefa ou procedimento recorrente. Use quando documentar tarefa que o time de ops precisa rodar repetidamente, transformar conhecimento tribal em comandos passo a passo, adicionar troubleshooting e rollback a procedimento existente, ou escrever caminhos de escalação para quando algo der errado. Agente Clawdia.---# /ops-runbook> Se encontrar placeholders desconhecidos ou precisar verificar quais ferramentas estão conectadas, consulte [CONNECTORS.md](../../CONNECTORS.md).Cria runbook operacional passo a passo para tarefa ou procedimento recorrente.## AgenteClawdia — hub operacional, calendário, emails, tarefas, decisões.## Output````markdown## Runbook: [Nome da Tarefa]**Responsável:** [Time/Pessoa] | **Frequência:** [Diária/Semanal/Mensal/Conforme Necessário]**Última Atualização:** [Data] | **Última Execução:** [Data]### Objetivo[O que esse runbook realiza e quando usar]### Pré-requisitos- [ ] [Acesso ou permissão necessária]- [ ] [Ferramenta ou sistema necessário]- [ ] [Dado ou input necessário]### Procedimento#### Etapa 1: [Nome]```[Comando exato, ação ou instrução]```**Resultado esperado:** [O que deve acontecer]**Se falhar:** [O que fazer]#### Etapa 2: [Nome]```[Comando exato, ação ou instrução]```**Resultado esperado:** [O que deve acontecer]**Se falhar:** [O que fazer]### Verificação- [ ] [Como confirmar que a tarefa foi concluída com sucesso]- [ ] [O que checar]### Troubleshooting| Sintoma | Causa Provável | Solução ||---------|---------------|---------|| [O que você vê] | [Por quê] | [O que fazer] |### Rollback[Como desfazer isso se algo der errado]### Escalação| Situação | Contato | Método ||----------|---------|--------|| [Quando escalar] | [Quem] | [Como contatar — Discord/WhatsApp/telefone] |### Histórico| Data | Executado por | Notas ||------|--------------|-------|| [Data] | [Pessoa] | [Issues ou observações] |````## Se Conectores DisponíveisSe **Notion MCP** estiver conectado:- Buscar runbooks existentes para atualizar em vez de criar do zero- Publicar o runbook finalizado na wiki de ops do NotionSe **Linear MCP** estiver conectado:- Vincular o runbook a tipos de incident e change requests relacionados- Referenciar issues de manutenção recorrentes## Dicas1. **Seja dolorosamente específico** — "Rodar o script" não é uma etapa. "Rodar `python sync.py --prod --dry-run` no servidor de ops" é.2. **Inclua modos de falha** — O que pode dar errado em cada etapa e o que fazer a respeito.3. **Teste o runbook** — Peça a alguém não familiarizado com o processo para segui-lo. Corrija onde travarem.

Frequently asked questions