it-problem-root-cause

Performs evidence-based root-cause analysis for recurring IT incidents and systemic failures.

Updated Jun 21, 2026
One-click install
npx skills add https://github.com/lwokeray/cowork-plugins --skill it-problem-root-cause-lwokeray
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: it-problem-root-cause
Source: https://github.com/lwokeray/cowork-plugins/tree/main/plugins/it-operations-cowork/skills/it-problem-root-cause
Command: npx skills add https://github.com/lwokeray/cowork-plugins --skill it-problem-root-cause-lwokeray

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Recurring incidents and major outages often get closed with superficial explanations like "human error" or "the deployment caused it," leading to repeat failures. This Skill enforces a disciplined, evidence-based root-cause analysis process that separates triggers, contributing factors, and control failures, so permanent fixes actually prevent recurrence. ## Core Features & Use Cases - Structured Causal Analysis: Builds normalized timelines, tests causal claims against evidence and counterevidence, and distinguishes trigger, direct cause, contributing factors, control failures, and root cause. - Known Error & Workaround Management: Records known errors and safe workarounds when permanent corrections are not yet ready. - Actionable Prevention Plans: Creates corrective and preventive actions with owners, priorities, due dates, and verification criteria, plus scheduled effectiveness reviews. - Use Case: After a third recurrence of a database outage, use this Skill to build a blameless postmortem that identifies the missing failover control as the root cause and assigns a verified fix instead of blaming the on-call engineer. ## Quick Start Analyze the attached incident records and logs to produce a blameless root-cause analysis with a timeline, causal chain, known error record, and corrective action plan.

Frequently Asked Questions about it-problem-root-cause

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

FAQPage Schema
How do I conduct a root-cause analysis for recurring IT incidents?▼

Start by defining the problem statement with affected service, scope, and time window, then build a normalized timeline from logs and incident records. Separate trigger, direct cause, contributing factors, and control failures, and test each causal claim against evidence before assigning corrective actions.

How to run a blameless postmortem after a major incident?▼

Focus the analysis on system conditions rather than individuals: identify the design, process, or control gap that allowed an ordinary action to cause failure. Record evidence and counterevidence for each causal link, and avoid labeling human error as a root cause.

When should I stop using the 5 Whys technique?▼

Use 5 Whys only as a questioning aid and stop where evidence stops. When the next causal fact cannot be established from available data, mark it as unknown rather than continuing into speculation.

What makes a corrective action effective in problem management?▼

Strong actions change the system, such as adding enforced validation, redundancy, automated controls, or actionable monitoring tied to ownership. Weak actions like "be careful" or "retrain staff" require a measurable control or verification step to count as complete.

Can root-cause analysis be done without live access to monitoring systems?▼

Yes, the analysis can be performed on user-provided or authorized exported data such as incident records, logs, and timelines. The output should note data dates, versions, and any scope that could not be verified in real time.

Why do incidents recur after a problem ticket is closed?▼

Recurrence usually means the corrective action only added documentation instead of breaking a causal link, or the fix was never verified. Reopen the problem record, evaluate action effectiveness, and confirm the control exists and is tested before closure.