root-cause-investigator SKILL.md skillA

root-cause-investigator from umputun/cc-thingz is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add umputun/cc-thingz/root-cause-investigator@git:20260217.d627b3f

Pins git:20260217.d627b3f in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
umputun/cc-thingz
Path
plugins/thinking-tools/skills/root-cause-investigator/SKILL.md
Versions recorded
1
Latest version
git:20260217.d627b3f, committed Feb 17, 2026
Size
3,515 bytes
Repository stars
492
License
MIT

Systematic root cause analysis for errors, bugs, and unexpected behaviors using 5-Why methodology. Use when user reports errors, build failures, test failures, performance issues, integration problems, or any "it's not working" scenarios.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Root Cause Investigator

Apply systematic 5-Why methodology to identify fundamental root causes of issues rather than treating symptoms. Guide thorough investigation through structured evidence gathering and analysis.

## Activation Triggers

- errors, bugs, or unexpected behavior
- build failures or test failures
- performance issues or degradation
- integration problems
- any "it's not working" scenarios

## The 5-Why Methodology

Systematically ask "why" five times to drill down to root cause:

1. **Why #1**: identify immediate cause (symptoms)
2. **Why #2**: uncover process/workflow issues
3. **Why #3**: find system-level problems
4. **Why #4**: discover design/architecture issues
5. **Why #5**: reveal fundamental root cause

## Investigation Workflow

### 1. Gather Initial Context

Collect information about the issue:

```
## Issue Summary
[brief description of reported problem]

## Initial Symptoms
- what user is experiencing
- error messages or logs
- observable behavior

## Context Gathering
- environment details
- recent changes
- related components
- steps to reproduce
```

### 2. Apply 5-Why Analysis

Structure the investigation with progressive depth:

```
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add umputun/cc-thingz/root-cause-investigator@sha256:eaeaeb08e6e125c1

The line at the top of this page pins the label git:20260217.d627b3f, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_lkpo6g6cygqwy44r.svg)](https://markdownregistry.com/a/art_lkpo6g6cygqwy44r)

5 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 1 version of this file, committed on Feb 17, 2026.

versioncommittedcommitsizeaudit
git:20260217.d627b3f latest2026-02-17 d627b3f 3,515 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (3515 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

umputun/cc-thingz · 492 stars · license MIT · pushed 2026-10-25 · branch master

API

GET https://markdownregistry.com/api/v1/artifacts/art_lkpo6g6cygqwy44r
GET https://markdownregistry.com/api/v1/resolve?ref=umputun/cc-thingz/root-cause-investigator
GET https://markdownregistry.com/api/v1/blob/eaeaeb08e6e125c1022f865f847e777fbff1782a389587a89e1a66e0ea9101f0

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from umputun/cc-thingz

CLAUDE.md CLAUDE.md file
umputun/cc-thingz · CLAUDE.md
git:20260820.2729925 · audit A · 492 stars
brainstorm SKILL.md skill
umputun/cc-thingz · plugins/brainstorm/skills/brainstorm/SKILL.md · Use before any creative work or significant changes. Activates on "brainstorm", "let's brainstorm", "deep analysis"…
git:20260504.5f947a7 · audit A · 492 stars
exec SKILL.md skill
umputun/cc-thingz · plugins/planning/skills/exec/SKILL.md · Execute plan tasks sequentially using subagents. Use when user says 'exec', 'execute plan', 'run plan', or wants to…
git:20261025.f84b93c · audit A · 492 stars
last-tag SKILL.md skill
umputun/cc-thingz · plugins/release-tools/skills/last-tag/SKILL.md · Show commits since the last tag in a formatted table. Use when user asks "what changed since last release", "commits…
git:20260402.605bef0 · audit A · 492 stars
new SKILL.md skill
umputun/cc-thingz · plugins/release-tools/skills/new/SKILL.md · Use when user asks to create a release, cut a release, or publish a version. Auto-detects GitHub vs GitLab vs Gitea…
git:20260821.6a59551 · audit A · 492 stars
git-review SKILL.md skill
umputun/cc-thingz · plugins/review/skills/git-review/SKILL.md · Interactive git diff annotation review. Generates a cleaned-up diff, opens in editor for user annotations, and…
git:20260817.d18d8f8 · audit A · 492 stars
pr SKILL.md skill
umputun/cc-thingz · plugins/review/skills/pr/SKILL.md · Comprehensive PR/issue review - analyzes architecture, tests, identifies unrelated changes mixed in, drafts review…
git:20260218.ebd1cfb · audit A · 492 stars
writing-style SKILL.md skill
umputun/cc-thingz · plugins/review/skills/writing-style/SKILL.md · Use for technical communication - GitHub/GitLab tickets, PR/MR descriptions, issue comments, code review comments…
git:20260330.c77a2aa · audit A · 492 stars
ask-codex SKILL.md skill
umputun/cc-thingz · plugins/thinking-tools/skills/ask-codex/SKILL.md · Consult OpenAI Codex for investigation, debugging, or code review. Use when user explicitly asks to "ask codex", "check…
git:20261018.9011e3c · audit A · 492 stars
dialectic SKILL.md skill
umputun/cc-thingz · plugins/thinking-tools/skills/dialectic/SKILL.md · Prove and counter-prove a statement using parallel agents to eliminate confirmation bias. Use when someone says…
git:20260217.d627b3f · audit A · 492 stars
backlog SKILL.md skill
umputun/cc-thingz · plugins/workflow/skills/backlog/SKILL.md · Read, work, and maintain a Git repo's deferred-work items in docs/backlog/, one file per item. Use when the user says…
git:20260823.b8f4a23 · audit A · 492 stars
clarify SKILL.md skill
umputun/cc-thingz · plugins/workflow/skills/clarify/SKILL.md · This skill should be used when user appears confused, frustrated, or shows misalignment between expectations and…
git:20260218.782e0e3 · audit A · 492 stars

Every file in umputun/cc-thingz

Browse by kind, by grade A, or by owner.