Skill103.5k repo starsupdated 4d ago

eng-runbook

The eng-runbook skill generates a single-page HTML engineering runbook by extracting service details from a DESIGN.md file and organizing them into a structured document. It includes service metadata, dependency lists, alert tables, dashboard links, common operational procedures with code examples, on-call rotation schedules, and incident response checklists, suitable for on-call engineers needing quick operational reference material.

View source Repository: open-design

Install in Claude Code

Copy

git clone --depth 1 https://github.com/nexu-io/open-design /tmp/eng-runbook && cp -r /tmp/eng-runbook/design-templates/eng-runbook ~/.claude/skills/eng-runbook

Then start a new Claude Code session; the skill loads automatically.

Definition

SKILL.md

# 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>
```