К основному содержанию
скилл CX Codex

runbook-generator · onewave-ai — скилл для Claude Code: генерация инструкций

Скилл runbook-generator для Claude Code анализирует код, конфигурацию инфраструктуры и скрипты деплоя, затем создаёт операционный runbook.md. Документ описывает выкладку, реагирование на инциденты и восстановление.

MIT 252 установок ★ 440 обновлён 2026-10-20

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add OneWave-AI/claude-skills --skill runbook-generator -a claude-code
Открыть на GitHub

Что делает runbook-generator

Сначала скилл ищет файлы и конфигурации проекта, затем анализирует IaC, контейнеры, CI/CD, настройки приложения, мониторинг и скрипты деплоя. По шаблону он формирует runbook.md с девятью разделами, командами из репозитория и диаграммой архитектуры. Результат — не краткая памятка: требуется документ объёмом от 500 строк с оглавлением.

Внутри есть инструкции по поиску файлов, шаблон структуры и правила оформления. Скилл проверяет, существуют ли упомянутые пути и скрипты; непроверенные детали помечает [VERIFY], а пробелы — [ACTION REQUIRED]: .... Он не должен додумывать устройство инфраструктуры. Это важно: runbook может содержать задачи на уточнение, если нужные сведения нельзя подтвердить по проекту.

Для работы с репозиторием используются Read, Glob, Grep, Bash, Write и Edit. Скилл записывает runbook.md в корень проекта или в указанную пользователем папку; команды в документе должны опираться на кодовую базу и включать ожидаемый результат.

Какие задачи решает

  • составить инструкции по деплою из конфигураций и скриптов проекта
  • описать действия при инцидентах и откате
  • собрать процедуры резервного копирования и восстановления
  • найти пробелы в эксплуатационной документации
  • проверить, существуют ли пути и скрипты из runbook

Примеры запросов агенту

  • Составь runbook.md для этого проекта с процедурами деплоя и отката.
  • Подготовь инструкции для дежурного инженера по реагированию на инциденты в этом сервисе.
  • Проверь конфигурации и создай runbook с командами восстановления.

Как установить runbook-generator

1Через Skills CLI (Vercel)

npx skills add OneWave-AI/claude-skills --skill runbook-generator -a claude-code

2Вручную: положить файлы

~/.claude/skills/runbook-generator/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/runbook-generator/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о runbook-generator

Как установить runbook-generator в Claude Code?

Выполните npx skills add OneWave-AI/claude-skills --skill runbook-generator -a claude-code. Файл скилла находится по пути ~/.claude/skills/runbook-generator/SKILL.md.

Что делает runbook-generator?

Он анализирует файлы проекта и создаёт runbook.md с эксплуатационными процедурами, командами и диаграммой архитектуры. Непроверенные детали и пробелы отмечаются специальными метками.

Какой объём и разделы будут у runbook?

Инструкция требует не менее 500 строк и девять разделов, а также оглавление. Содержание разделов адаптируется к тому, что удалось найти в проекте.

Исходный текст

SKILL.md · MIT
---
name: runbook-generator
description: 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.
tools: Read, Glob, Grep, Bash, Write, Edit
model: inherit
---

# 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

1. Discover the system. Run the Glob patterns in `references/discovery-patterns.md` (Step 1) to identify the stack and infrastructure.
2. 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.
3. 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.
4. Generate the runbook. Produce `runbook.md` following the structure in `references/output-template.md`. Cover all 9 sections; adapt content to what discovery found; never include purely speculative sections.
5. 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.
6. 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.

© OneWave-AI · MIT · OneWave-AI/claude-skills

Похожие скиллы

Все скиллы по теме «DevOps и инфраструктура» →

Сначала — runbook-generator от других авторов.

runbook-generator Alireza Rezvani Скилл runbook-generator генерирует каркас эксплуатационного runbook по имени сервиса: для развёртывания, инцидентов, обслуживания и отката. Пригодится перед запуском нового сервиса. CX Codex +1 600установок incident-runbook-templates Seth Hobson Скилл incident-runbook-templates помогает писать пошаговые инструкции для инцидентов: от обнаружения и первичной проверки до восстановления, отката и эскалации. CX Codex +1 10 900установок runbook официальный anthropics Скилл превращает повторяемую операцию в пошаговый runbook с проверкой, устранением сбоев, откатом и маршрутом эскалации. CX Codex +1 3 300установок runbook-creation devops-skills Скилл runbook-creation помогает писать операционные runbook'и, регламенты и инструкции по восстановлению, по которым дежурный инженер сможет действовать без раздумий. CX Codex +1 388установок launch-runbook rampstackco Скилл launch-runbook для Claude Code составляет и проводит структурированный запуск: проверки перед go-live, процедуры отключения DNS, мониторинг после запуска и откат. Описывает запуск сайта, продукта или крупного релиза. CX Codex +1 325установок backup-restore-runbook-generator patricio0312rev Скилл backup-restore-runbook-generator для Claude Code создаёт планы аварийного восстановления баз данных, скрипты бэкапа и проверки restore. Включает DR-планирование и подготовку процедур отката. CX Codex +1 294установок eng-runbook nexu-io Скилл eng-runbook создаёт одностраничный HTML-ранбук сервиса с таблицей алертов, процедурами деплоя и чек-листом инцидентов. Пригодится дежурным инженерам и SRE-командам. CX Codex +1 231установок

Из того же набора185

Весь набор →
overnight-repo-auditor Скилл overnight-repo-auditor запускает автономный ночной аудит репозитория по безопасности, качеству кода и зависимостям без лишних вопросов к разработчику. CX Codex +1 253установок cowork-deal-room Скилл cowork-deal-room разбирает документы сделки по пяти этапам и собирает отчёт о рисках, условиях, находках и пунктах для переговоров. CX Codex +1 253установок lead-scoring-model Скилл lead-scoring-model анализирует историю закрытых сделок и строит модель оценки лидов, привязанную к реальным данным вашей компании. Генерирует документацию с размерами оценки, пороговыми значениями и инструкциями по внедрению в CRM. CX Codex +1 253установок incident-responder Скилл incident-responder помогает расследовать сбои: проверяет логи и недавние изменения, оценивает серьёзность и готовит отчёт с причиной и мерами профилактики. Пригодится во время инцидента и после восстановления. CX Codex +1 253установок data-pipeline-builder Скилл data-pipeline-builder проектирует и собирает ETL/ELT-пайплайн: код на Python или SQL, DAG для Airflow, проверки качества и спецификацию в data-pipeline-spec.md. CX Codex +1 252установок roi-calculator Скилл roi-calculator считает окупаемость внедрения ИИ по вашим затратам, ручным часам и ставкам, а затем пишет отчёт с окупаемостью и сценариями. CX Codex +1 252установок investor-update-writer Скилл investor-update-writer собирает ежемесячные и квартальные отчёты для инвесторов в файл investor-update.md на основе метрик, финансов и новостей команды. CX Codex +1 252установок onboarding-checklist Создаёт поэтапный чек-лист онбординга клиентов в файле onboarding-checklist.md с шаблонами писем и распределением ролей под консалтинг, SaaS или агентство. CX Codex +1 251установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой