Process Troubleshooting & Root Cause Analysis Framework
Diagnose process failures with systematic root cause analysis
What You Can Do
You'll work through a structured 5-phase troubleshooting framework to identify the true root causes of process anomalies—not just symptoms. The framework guides you to gather relevant data, generate and test hypotheses, rank probable causes by evidence, and design corrective actions with prevention measures. You'll produce clear documentation suitable for incident reviews and process improvements.
Features
Problem definition → Data collection → Hypothesis generation → Evidence evaluation → Action planning
Checklist of metrics, logs, timestamps, and context to capture before analysis begins
Brainstorm likely causes using failure mode thinking, recent changes, and operating conditions
Score each hypothesis against available data (correlation, timeline, plausibility) to rank by likelihood
Generate immediate fixes, preventive measures, and monitoring strategies
Structure your findings as post-mortem reports with clear cause statements and lessons learned
Identify who to involve (ops, engineering, product, vendor) and what questions to ask them
Example Output
Example 1: Production Database Timeout
Problem: Customer-facing API timing out under normal load (noon UTC, 50% of baseline requests failed)
Root Cause Hypotheses (ranked by evidence):
- Recent query optimization rollback — Timeline matches last deploy 3h ago; DBA confirms revert happened
- Disk I/O saturation — Monitoring shows 85% utilization but stable; doesn't explain sudden failure
- Memory leak in connection pool — Memory flat; pool exhaustion would show queue delays (absent)
Immediate Action: Revert optimization change → Service restored in 8 minutes
Prevention: Add pre-deploy load test; require performance sign-off on all query changes
Example 2: Manufacturing Line Defect Spike
Problem: Widget defect rate jumped from 2% to 8% Thursday 2pm; no line shutdown events recorded
Root Cause Hypotheses:
- New batch of raw material (HIGH) — Supplier batch #47291 received Wed; QC passes but material properties drift slightly
- Calibration drift on press #3 — Last calibrated Monday; runs +0.3mm but within spec historically
- Humidity spike in production floor — Actually dropped Thurs; rules out moisture sensitivity
Immediate Action: Quarantine material batch; retest supplier lot → Defect rate returns to 2%
Prevention: Add incoming material batch traceability; tighten supplier specifications
What's Included
- SKILL.md: Complete troubleshooting framework with decision trees and phase workflows
- Data Collection Checklist: Metrics, logs, timeline, environmental context, recent changes
- Root Cause Hypothesis Template: Structure for brainstorming and documenting suspected causes
- Evidence Evaluation Matrix: Scoring rubric to rank hypotheses (correlation, timeline, plausibility, testability)
- Corrective Action Plan Template: Immediate fix, preventive measures, monitoring strategy, owner assignments
- Incident Post-Mortem Guide: Writing structure for incident reports and lessons learned
Who It's For
- Operations and DevOps engineers — Debugging production outages and service failures
- Process improvement specialists — Systematic analysis for Six Sigma and Lean initiatives
- Manufacturing/production leads — Root cause analysis for line stoppages and defect spikes
- Incident response teams — Structured post-mortem analysis and action planning
- Quality assurance managers — Problem trending and corrective action tracking
Best For
- Production outages and unexpected service failures requiring rapid diagnosis
- Process degradation — gradual performance drops, increasing defect rates, or rising error counts
- Recurring incidents — identifying systemic causes after multiple similar failures
- Equipment malfunctions and anomalies in manufacturing or infrastructure
- Post-mortem incident reviews and prevention planning
You might also like
Analyze chemical processes systematically to identify hazards, assess risks, and generate safety recommendations. You can perform HAZOP analyses, evaluate compliance with industry standards, conduct root-cause analysis of incidents, and develop emergency response procedures. The skill guides you through structured safety reviews that reduce the likelihood of accidents and regulatory violations.
You'll develop systematic approaches to injectable formulation design, from API selection through sterilization strategy. Claude helps you troubleshoot failed batches by analyzing root causes, recommends regulatory pathways (505(b)(2), ANDA, NDA), and provides science-backed solutions for stability, compatibility, and manufacturability challenges.
This skill helps you systematically assess integration needs across your systems, design architecture patterns that scale with your organization, and identify technical and operational risks before implementation. You'll receive architecture recommendations aligned to your business constraints, clear integration roadmaps, and risk mitigation strategies that reduce deployment surprises. Get structured decision records suitable for architecture review boards and engineering teams.
You can conduct comprehensive hazard analyses for chemical processes using industry-standard methodologies like HAZOP and LOPA. The skill helps you assess risks quantitatively, identify control gaps, design engineered safeguards, and generate formal documentation for regulatory compliance and process safety management.
Claude analyzes your code diffs and generates standardized commit messages that follow the Conventional Commits specification. The skill automatically determines the correct commit type, scope, and description based on the changes you've made, ensuring your messages are parseable by automation tools while remaining human-readable for code reviewers.
You can transform raw text into structured, labeled datasets for machine learning, analysis, and research. This skill performs named entity recognition, sentiment classification, part-of-speech tagging, and dependency parsing—generating consistent, validated annotations at scale. Use it to prepare corpora, extract entities, classify documents, or perform linguistic analysis without manual annotation.
This skill helps you systematically analyze service mesh architectures, identify inter-service communication failures, and design optimal routing and security policies. You'll receive step-by-step troubleshooting guidance tailored to your mesh platform (Istio, Linkerd, Consul), configuration validation reports, and architectural recommendations that reduce latency, improve observability, and tighten security posture.
Rapidly analyze firmware logs and diagnose hardware issues that cause device failures, connectivity problems, and performance degradation. You'll identify root causes from stack traces, crash dumps, and sensor data, then generate specific optimization recommendations. This skill transforms raw device logs into actionable debugging plans that reduce time-to-resolution from hours to minutes.