
Engineering Runbook
FreeCreate structured engineering runbooks with ease.
Free · Opens the source repo
What Engineering Runbook does
The Engineering Runbook skill is designed to streamline the creation of comprehensive engineering runbooks, which are essential for operational efficiency and incident management. This skill provides a structured approach to documenting critical service information, including an overview of the service, alert details, dashboards, common operational procedures, and incident response protocols. By following a clear workflow, users can generate a single-page runbook that serves as a valuable resource for on-call engineers and site reliability teams.
To utilize the skill, users begin by reading the DESIGN.md file to gather necessary context about the service. The skill guides users through a series of steps to compile relevant information, such as the service name, owner team, severity tier, and version. It includes sections for an alerts table that details alert names, severity levels, and initial response actions, as well as a list of dashboards and links that are pertinent to the service's operation.
Additionally, the runbook includes a block for common procedures, providing copy-pasteable commands for tasks like deployment and key rotation. An on-call rotation table ensures that team members know their responsibilities, while an incident response checklist offers a clear sequence of actions to take during incidents. The output is structured in semantic HTML, ensuring that it is easy to read and use.
This skill is particularly useful for engineering teams looking to improve their operational documentation and incident response processes. By providing a standardized format, it helps ensure that all necessary information is readily available and easily accessible, reducing the time spent searching for critical operational details during high-pressure situations.
When to use it
Use this skill when you need to create a runbook for a service, especially during onboarding or when updating operational procedures.
When not to use it
This skill is not suitable for ad-hoc documentation needs or for services that do not require a structured runbook format.
What you can build with it
Onboarding New Services
When onboarding a new service, use this skill to create a runbook that documents all necessary operational details for the team.
Incident Management
During an incident, quickly reference the runbook generated by this skill to follow established procedures and response steps.
Updating Operational Procedures
Use this skill to regularly update and maintain runbooks as services evolve, ensuring all team members have access to current information.
How to install Engineering Runbook
View source1. Install with the skills CLI
npx skills add nexu-io/open-design/eng-runbook --agent claude-code2. Or install it manually
Download the skill folder and drop it into ~/.claude/skills/ for all projects, or .claude/skills/ to scope it to one repo. Restart Claude Code so it picks up the new skill.
Anthropic's agentic coding CLI, and the reference implementation of Agent Skills. Drop a skill folder into ~/.claude/skills and Claude Code loads it automatically whenever a task matches the skill's description. Claude Code docs
Inside SKILL.md
Written by nexu-ioEngineering Runbook Skill
Produce a single-page engineering runbook.
Workflow
- Read DESIGN.md.
- Identify the service from the brief.
- 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).
- One inline
<style>, semantic HTML, monospace for code blocks.
Output contract
<artifact identifier="runbook-name" type="text/html" title="Service Runbook">
<!doctype html>...</artifact>
Frequently asked questions about Engineering Runbook
Similar skills
Turborepo
Optimized build system for JavaScript/TypeScript monorepos.
Azure Pipelines Validation
Streamline your Azure DevOps pipeline changes locally.
Azure Developer CLI
Streamline your Azure project workflows with best practices.
Azure Container Registry CLI
Manage Azure Container Registry resources with ease.
Aspire
Build and orchestrate polyglot distributed applications seamlessly.
Vercel CLI
Manage and deploy Vercel projects from the command line.
