Skip to main content
skill CX Codex

eng-runbook — Claude Code skill: what it does, how to install

eng-runbook generates a single-page HTML operations runbook with alerts, incident checklists, and terminal commands. Useful for on-call engineers and SRE teams.

Apache-2.0 231 installs ★ 108,855 updated 2026-10-25

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add nexu-io/open-design --skill eng-runbook -a claude-code
Open on GitHub

What eng-runbook does

This skill writes a standalone HTML runbook for any backend or platform service. The resulting document groups the team owner, severity tier, dependencies, and monitoring dashboards into a single view. It also formats an alerts table detailing severities and first-response instructions, alongside a five-step incident resolution checklist.

Common procedures feature terminal-ready snippets for actions like deploys, rollbacks, and key rotations. Monospace styling keeps shell commands legible.

The skill expects a DESIGN.md file in the project before generating markup. Without it, the layout will miss tokens for colors, typography, and spacing defined by the local design system.

What it helps with

  • generate an on-call runbook for a production service
  • document alert severities and immediate triage steps
  • build a quick-reference page with deploy and rollback commands
  • structure a five-step incident triage checklist

Example prompts for the agent

  • Write a runbook for our auth service with alerts, dashboards, and rollback commands
  • Draft an ops doc for the billing worker including an on-call rotation schedule
  • Create an SRE doc with dependency mapping and key rotation steps

How to install eng-runbook

1Skills CLI (Vercel)

npx skills add nexu-io/open-design --skill eng-runbook -a claude-code

2Manually: put the files in place

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

Copy the whole skill folder; for one project use .claude/skills/eng-runbook/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about eng-runbook

How do I install eng-runbook in Claude Code?

Run npx skills add nexu-io/open-design --skill eng-runbook -a claude-code. The skill definition will be saved to ~/.claude/skills/eng-runbook/SKILL.md.

What output format does eng-runbook produce?

It outputs a semantic HTML file inside an artifact block, styled with an inline <style> block and monospace code snippets.

What prerequisites does the runbook skill require?

The skill workflow requires a DESIGN.md file in the workspace to supply styling specifications for colors, typography, and layout.

Source text

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

Similar skills

All skills for DevOps and infrastructure →

From the same set140

The whole set →
pm-spec pm-spec builds a one-page PRD with the problem, metrics, scope, user stories, design notes, rollout plan, and open questions. CX Codex +1 234installs meeting-notes Builds a single-screen meeting notes page with an agenda, decisions, action items, and a next-meeting footer. Made for desktop prototypes. CX Codex +1 233installs dating-web The dating-web skill outputs a single HTML dashboard for a dating or matchmaking product, with sidebar navigation, a KPI grid, a 30-day matches bar chart and a trend panel. CX Codex +1 233installs hr-onboarding hr-onboarding creates a single-page HTML onboarding plan with a first-week schedule, 30/60/90-day milestones, resources, and a readiness checklist. CX Codex +1 233installs image-poster image-poster builds structured prompts for posters and cover art, then runs a local CLI dispatcher. Saves finished PNG files directly to your project folder. CX Codex +1 229installs team-okrs Generates a single-screen desktop HTML prototype for tracking team OKRs. It comes in handy when you need a quarterly goal dashboard with progress bars and status badges. CX Codex +1 229installs audio-jingle audio-jingle generates jingles, voiceover, and sound effects. Routes music to Suno V5, Udio, or Lyria; speech to MiniMax TTS or ElevenLabs V3; SFX to ElevenLabs SFX or AudioCraft. CX Codex +1 211installs video-shortform video-shortform produces 3–10 second video clips — product reveals, motion teasers, ambient loops — and saves a single MP4 into the project folder. CX Codex +1 210installs

Project sponsors

Companies that keep this analytics open