sdd-runbook

Generates incident response runbooks from design and SLO specification documents.

Updated Mar 23, 2026
One-click install
npx skills add https://github.com/sakamotomomotaro0809-netizen/tateyomi --skill sdd-runbook-sakamotomomotaro0809-netizen
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: sdd-runbook
Source: https://github.com/sakamotomomotaro0809-netizen/tateyomi/tree/main/taisun_agent/.claude/skills/sdd-runbook
Command: npx skills add https://github.com/sakamotomomotaro0809-netizen/tateyomi --skill sdd-runbook-sakamotomomotaro0809-netizen

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When a production incident occurs, teams without a prepared runbook waste critical minutes deciding what to check and which commands to run. This Skill generates a structured incident response runbook from existing design and SLO documents so on-call engineers can respond quickly and consistently. ## Core Features & Use Cases - Severity Definitions: Standardizes SEV1–SEV4 classifications with numeric first-response and resolution targets. - Scenario-Based Procedures: Produces copy-paste-ready diagnostic and mitigation commands for high latency, error spikes, database failures, resource exhaustion, external API outages, and security incidents. - Rollback & Postmortem Sections: Includes application, database migration, and configuration rollback steps plus a postmortem template for root cause analysis. - Use Case: After finishing a spec-driven design for a service, run the Skill with the spec slug to produce a runbook.md containing on-call contacts, emergency kubectl/psql commands, recovery checklists, and incident closure criteria. ## Quick Start Generate an incident response runbook for the google-ad-report spec using its existing design.md and slo.md files.

Frequently Asked Questions about sdd-runbook

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate an incident response runbook for my service?▼

Run the Skill with your spec slug, for example /sdd-runbook google-ad-report. It reads design.md and slo.md from the spec directory and writes a runbook.md containing severity definitions, scenario procedures, and rollback steps.

What inputs are required to create a runbook?▼

The Skill requires a design.md describing the system architecture and an slo.md defining SLI and alert conditions, both located in the target spec directory. Without these files the runbook cannot be generated.

What severity levels does an incident runbook define?▼

The runbook defines four levels: SEV1 for full outages with 15-minute first response, SEV2 for major feature failures, SEV3 for limited impact issues, and SEV4 for minor problems with a one-week resolution target.

Which incident scenarios does the runbook cover?▼

It covers high latency, high error rates, database connection failures, memory and CPU exhaustion, external API failures, and security incidents. Each scenario includes symptom definitions, verification commands, and prioritized mitigations.

Can I specify a custom output directory for the runbook?▼

Yes, pass an optional second argument as the target directory. If omitted, the Skill defaults to .kiro/specs/<spec-slug>/ and writes runbook.md there.