eng-runbook — скилл для Claude Code: что делает и как установить
Скилл eng-runbook создаёт одностраничный HTML-ранбук сервиса с таблицей алертов, процедурами деплоя и чек-листом инцидентов. Пригодится дежурным инженерам и SRE-командам.
Apache-2.0 231 установок ★ 108 855 обновлён 2026-10-25
npx skills add nexu-io/open-design --skill eng-runbook -a claude-codeЧто делает eng-runbook
Скилл генерирует готовую HTML-страницу инженерного руководства по эксплуатации для конкретного сервиса. На выходе получается единый документ с инлайн-стилями: шапка с владельцами и уровнем критичности, описание зависимостей, таблица алертов с первыми шагами реакции, ссылки на дашборды, график дежурств и чек-лист разбора инцидентов из пяти шагов.
В блок типовых процедур входят 3–4 готовые команды для вставки в терминал — обычно это развёртывание, откат релиза или ротация секретов.
Рабочий процесс прямо завязан на файл DESIGN.md: скилл читает дизайн-систему проекта перед вёрсткой, поэтому без этого файла оформление интерфейса потеряет заданные шрифты и цветовую палитру.
Какие задачи решает
- составить руководство по реагированию на алерты сервиса
- оформить график дежурств on-call команды
- подготовить пошаговый чек-лист действий при инцидентах
- собрать команды деплоя, отката и ротации ключей в единый документ
Примеры запросов агенту
- Собери runbook для сервиса авторизации: добавь алерты, ссылки на дашборды и команды отката
- Напиши ops doc для платёжного шлюза с таблицей дежурств и списком зависимостей
- Подготовь SRE doc по сервису уведомлений с пятишаговым планом разбора инцидента
Как установить eng-runbook
1Через Skills CLI (Vercel)
npx skills add nexu-io/open-design --skill eng-runbook -a claude-code2Вручную: положить файлы
~/.claude/skills/eng-runbook/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/eng-runbook/
1Через Skills CLI (Vercel)
npx skills add nexu-io/open-design --skill eng-runbook -a codex2Вручную: положить файлы
.agents/skills/eng-runbook/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add nexu-io/open-design --skill eng-runbook -a cursor2Вручную: положить файлы
.cursor/skills/eng-runbook/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install nexu-io/open-design design-templates/eng-runbook/SKILL.md2Вручную: положить файлы
.github/skills/eng-runbook/SKILL.md1Через Skills CLI (Vercel)
npx skills add nexu-io/open-design --skill eng-runbook -a gemini-cli2Командой платформы
gemini skills install https://github.com/nexu-io/open-design --path design-templates/eng-runbookВручную: положить файлы
.devin/skills/eng-runbook/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add nexu-io/open-design --skill eng-runbook -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы об eng-runbook
Как установить eng-runbook в Claude Code?
Запустите команду npx skills add nexu-io/open-design --skill eng-runbook -a claude-code. Файл навыка сохранится по пути ~/.claude/skills/eng-runbook/SKILL.md.
Что делает скилл eng-runbook?
Он собирает одностраничную HTML-документацию по эксплуатации сервиса, включая карточку сервиса, таблицу триггеров мониторинга, часто используемые консольные команды и график ротации дежурных.
В каком формате скилл отдаёт результат?
Скилл генерирует единый HTML-артефакт с тегом <!doctype html>, семантической разметкой и встроенным блоком <style>.
Исходный текст
SKILL.md · Apache-2.0
---
name: eng-runbook
description: |
An engineering runbook — service overview, alerts table, dashboards
links, common procedures with copy-pasteable commands, on-call rotation,
and an incident-response checklist. Use when the brief mentions
"runbook", "ops doc", "on-call guide", "SRE doc", or "运维手册".
triggers:
- "runbook"
- "ops doc"
- "on-call"
- "sre doc"
- "service runbook"
- "运维手册"
od:
mode: prototype
platform: desktop
scenario: engineering
preview:
type: html
entry: index.html
design_system:
requires: true
sections: [color, typography, layout, components]
example_prompt: "Write a runbook for our auth service — alerts, dashboards, common procedures, on-call rotation."
---
# Engineering Runbook Skill
Produce a single-page engineering runbook.
## Workflow
1. Read DESIGN.md.
2. Identify the service from the brief.
3. Layout:
- Header: service name, owner team, severity tier, version.
- Service summary paragraph + dependency list.
- Alerts table: alert name / severity / what it means / first response.
- Dashboards & links list.
- Common procedures block (3–4) with code blocks (deploy, rollback, rotate keys).
- On-call rotation table (week / primary / secondary / backup).
- Incident response checklist (5 numbered steps).
4. One inline `<style>`, semantic HTML, monospace for code blocks.
## Output contract
```
<artifact identifier="runbook-name" type="text/html" title="Service Runbook">
<!doctype html>...</artifact>
```
© nexu-io · Apache-2.0 · nexu-io/open-design