mcpField
E
eng-runbook

eng-runbook

github.com/mphinanceDocuments3284 installsUpdated 3d ago
Repository

About eng-runbook

An engineering runbook skill that produces a single-page HTML runbook from a service brief and DESIGN.md. Its specified layout covers service details, alerts, dashboards, procedures, on-call rotations, and incident response.

Key features

  1. 01Read DESIGN.md and service brief
  2. 02Summarize service and dependencies
  3. 03Create an alerts table
  4. 04List dashboards and links
  5. 05Include procedures and on-call details
  6. 06Add incident response checklist

Use cases

  1. 01Creating a concise service runbook
  2. 02Documenting alert responses and procedures
  3. 03Organizing on-call and incident steps

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/mphinance/alpha-skills --skill eng-runbook

After installing, type/eng-runbookin Claude Code to confirm it loaded.

Bundled filesexample.htmlREADME.md

Details

From the project README

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>

Comments

Markdown supported