What is a troubleshooting runbook?

A troubleshooting runbook is a standardized, step-by-step guide used by engineers to diagnose and resolve specific operational issues or system failures efficiently and consistently.

How does this skill help reduce MTTR?

It provides pre-structured decision trees, quick-check templates, and hypothesis testing frameworks that allow responders to bypass guesswork and identify the root cause faster during outages.

Does this skill help with post-incident documentation?

Absolutely. It includes templates for systematic debugging and correlation analysis, which are essential for creating professional Root Cause Analysis (RCA) reports.

Troubleshooting Runbooks Creator

Name: Troubleshooting Runbooks Creator
Author: TheBushidoCollective

byTheBushidoCollective

•

Deployment & DevOps

Generates systematic diagnostic procedures and operational runbooks for resolving complex software and infrastructure issues.

This skill empowers developers and SREs to build professional-grade troubleshooting documentation using a structured 5-step methodology. It provides templates for root cause analysis, decision trees for rapid diagnosis, and layered troubleshooting strategies covering application, infrastructure, and external dependencies. By standardizing the creation of these guides, it ensures teams can respond to incidents with consistency, reduce Mean Time to Recovery (MTTR), and preserve institutional knowledge through high-quality documentation.

Key Features

01Scientific method integration for hypothesis testing and validation

02Interactive decision tree templates for rapid incident triage

03Time-boxed investigation strategies for critical production outages

04Standardized 5-step troubleshooting framework (Observe to Verify)

0597 GitHub stars

06Layered diagnostic patterns for App, Infra, and External dependencies

Use Cases

01Building systematic diagnostic procedures for complex infrastructure failures

02Documenting Post-Mortem Root Cause Analysis (RCA) after system incidents

03Creating 'On-Call' runbooks for production microservices and APIs

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add thebushidocollective/han troubleshooting-guides

For use in Claude.ai and ChatGPT

Download Skill