Agent skill

Rca Methodology

by revfactory in revfactory/harness-100

Detailed guide for Root Cause Analysis (RCA) methodologies. An agent skill from revfactory/harness-100.

Apache-2.0Auto-check passedDevelopment

Install Rca Methodology

skills CLI
$ npx skills add revfactory/harness-100 --skill rca-methodology -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install revfactory/harness-100 rca-methodology --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/revfactory/harness-100.git skills-src && mkdir -p .claude/skills && cp -r skills-src/en/25-incident-postmortem/.claude/skills/rca-methodology .claude/skills/rca-methodology && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
rca-methodology
GitHub stars
1.3k
Token cost
~1.5k tokens
SKILL.md length
258 words
Files
1
Skills in repo
464
Repo updated
First seen
Licence
Apache-2.0

At a glance

Detailed guide for Root Cause Analysis (RCA) methodologies. An agent skill from revfactory/harness-100.

  • Works in 4 steps: 5 Whys Technique → Fishbone Diagram (Ishikawa) → Fault Tree Analysis (FTA) → …
  • Root cause analysis
  • SKILL.md covers 1. 5 Whys Technique, 2. Fishbone Diagram (Ishikawa), 3. Fault Tree Analysis (FTA) and 4. Change Analysis, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Rca Methodology is an agent skill from revfactory/harness-100. Detailed guide for Root Cause Analysis (RCA) methodologies. Structured RCA techniques including 5 Whys, Fishbone diagrams, Fault Tree Analysis, change analysis, and a cognitive bias prevention checklist. Use this skill for 'root cause analysis', 'RCA', '5 Whys', 'fishbone', 'Fault Tree', 'cause analysis methodology', 'change analysis', and other incident cause analysis tasks. Enhances the analysis capabilities of root-cause-investigator. Note: timeline reconstruction and remediation planning are outside the scope…

Its SKILL.md is about 1.5k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development, covering Root cause analysis and Marketing psychology. The licence is Apache-2.0.

When your agent uses it

  • Root cause analysis
  • Cause analysis methodology
  • Change analysis
  • Other incident cause analysis tasks

Example prompts

  • “root cause analysis”
  • “5 Whys”
  • “fishbone”
  • “/rca-methodology”

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. 5 Whys Technique
  2. Fishbone Diagram (Ishikawa)
  3. Fault Tree Analysis (FTA)
  4. Change Analysis

What it can do on your machine

Read from SKILL.md and the folder at commit 8e8d35c. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are markdown).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Rca Methodology loads about 1.5k tokens when it runs. Until then it costs about 137 tokens; SKILL.md has 258 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~137
When it runs · the whole SKILL.md, loaded when a task matches
~1.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from revfactory/harness-100 at commit 8e8d35c, republished under its Apache-2.0 licence (© revfactory). 258 words, ~1,497 tokens.

Download SKILL.mdSave it as .claude/skills/rca-methodology/SKILL.md (or your agent's skills folder).
name
rca-methodology
description
Detailed guide for Root Cause Analysis (RCA) methodologies. Structured RCA techniques including 5 Whys, Fishbone diagrams, Fault Tree Analysis, change analysis, and a cognitive bias prevention checklist. Use this skill for 'root cause analysis', 'RCA', '5 Whys', 'fishbone', 'Fault Tree', 'cause analysis methodology', 'change analysis', and other incident cause analysis tasks. Enhances the analysis capabilities of root-cause-investigator. Note: timeline reconstruction and remediation planning are outside the scope of this skill.

RCA Methodology — Root Cause Analysis Methodology Guide

A collection of structured analysis techniques for systematically tracing incident root causes.

1. 5 Whys Technique

Procedure
Problem: Payment service was down for 30 minutes.

Why 1: Why did the payment service go down?
-> The DB connection pool was exhausted.

Why 2: Why was the connection pool exhausted?
-> Slow queries held connections for extended periods.

Why 3: Why did slow queries occur?
-> A full table scan was performed without an index.

Why 4: Why was there no index?
-> The index addition was missed in the migration during the new feature deployment.

Why 5: Why was the missing index not detected?
-> Query performance verification was not included in the deployment pipeline.

Root Cause: Absence of query performance verification step in the deployment pipeline
5 Whys Pitfalls
PitfallDescriptionPrevention
Stopping too earlyConcluding at step 2-3Verify: "Would fixing this prevent recurrence?"
Leading to blameEnding with "who made the mistake"Focus on system/process causes
Single path onlyMissing compound causesReview branches at each step
Speculation-based answersHypotheses without evidenceVerify with logs/metrics

2. Fishbone Diagram (Ishikawa)

                    +- People -------- Insufficient deployer training
                    |                  Code review skipped
                    |
                    +- Process -------- Deployment checklist not followed
                    |                   Performance testing not conducted
                    |
Payment Svc Down <--+- Technology ---- Missing index
                    |                   Connection pool size insufficient
                    |
                    +- Environment ---- Production data scale not reflected
                    |                   Staging environment mismatch
                    |
                    +- Monitoring ----- Slow query alert not configured
                                        DB metrics dashboard absent
6M Categories (Software Application)
Traditional 6MSoftware ApplicationInvestigation Items
ManPeople/TeamTraining, communication, on-call structure
MethodProcessDeployment procedures, change management, approval flows
MachineTechnology/InfrastructureServers, DB, network, code
MaterialData/InputInput data, external API responses
MeasurementMonitoringAlerts, metrics, logs, tracing
EnvironmentEnvironmentConfiguration, env vars, dependent services

3. Fault Tree Analysis (FTA)

                    Payment Service Outage (Top Event)
                          |
                    +-----| OR |-----+
                    |                |
              DB Failure        Application Failure
                |                    |
          +-----| OR |-----+  +---| AND |---+
          |                |  |             |
    Pool Exhaustion   Disk Full  Slow Queries  High Traffic
          |                        |
    +-----| AND |-----+     +-----| OR |-----+
    |                |     |                |
 Missing Index  Large Data  New Code Deploy  Schema Change

Probability Calculation:

OR gate:  P(A OR B)  = 1 - (1-P(A)) x (1-P(B))
AND gate: P(A AND B) = P(A) x P(B)

Example: P(slow query)=0.3, P(high traffic)=0.2
    P(app failure) = 0.3 x 0.2 = 0.06 (6%)

4. Change Analysis

markdown
Investigate changes before and after the incident:

| Change Time | Change Content | Changed By | Impact Scope | Incident Correlation |
|------------|---------------|-----------|-------------|---------------------|
| T-2h | Payment API v2.3 deploy | Dev team | Payment service | HIGH |
| T-1h | Redis config change | Ops team | Cache service | MEDIUM |
| T-30m | CDN cache purge | Marketing | Frontend | LOW |

Correlation criteria:
1. Temporal proximity: Change time <-> Incident time
2. Scope match: Change scope <-> Incident impact scope
3. Rollback effect: Whether rolling back the change resolves the incident

Cognitive Bias Prevention Checklist

BiasDescriptionPrevention
Confirmation biasCollecting only evidence matching the first hypothesisActively search for counterexamples
Hindsight bias"Obviously this was the cause"Judge based only on information available at the time
Availability biasEquating with recently experienced similar incidentsEnforce evidence-based analysis
Fundamental attribution errorAttributing to human errorPrioritize system/process causes
AnchoringFixating on initial report contentAnalyze independently from multiple perspectives

RCA Technique Selection Guide

SituationRecommended TechniqueReason
Simple incident, quick analysis needed5 WhysLightweight, can be done immediately
Suspected compound causesFishboneMulti-dimensional cause exploration
Safety-related severe incidentsFTAQuantitative, systematic
Post-deployment incidentsChange AnalysisNarrow down cause candidates
All cases5 Whys + Change Analysis combinedFast yet systematic

© revfactory, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in en/25-incident-postmortem/.claude/skills/rca-methodology of revfactory/harness-100.

Open the folder on GitHubat commit 8e8d35c

Compare with similar skills

Rca Methodology next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Rca Methodology compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Rca Methodology this skillrevfactory/harness-1001.3k—~1.5kAutomated safety check: PassApache-2.0
Code Design Rationale Investigatorcursor/plugins10k9 repos~2.6kAutomated safety check: PassNone
OpenLogi macOS Permissions TriageAprilNEA/OpenLogi23k—~2.5kAutomated safety check: NotesApache-2.0
Bug Finder for daisyUIsaadeghi/daisyui43k—~2.3kAutomated safety check: PassMIT
Root Cause Debugginggarrytan/gstack136k—~1.4kAutomated safety check: PassMIT
Graph-Based Bug Tracingtirth8205/code-review-graph32k1 repos~287Automated safety check: PassMIT

Similar skills

  • Official

    Digs into why code is shaped the way it is by checking git history, pull requests and connected tools in parallel, then reporting a cited read on the tradeoffs.

    10k GitHub starsUsed in 9 repos~2.6k tokens
    DevelopmentAuto-check passed
  • Decides whether an OpenLogi device problem on macOS is a privacy-permission (TCC) problem, using agent log lines, and says which identity needs which grant.

    23k GitHub stars~2.5k tokensUpdated 3 days ago
    DevelopmentAuto-check: notes
  • Bug Finder for daisyUI

    saadeghi/daisyui

    Investigates suspected bugs in the daisyUI monorepo through read-only analysis, then writes a decision-ready fix plan in tmp/bugs without changing any product code.

    43k GitHub stars~2.3k tokensUpdated 7 days ago
    DevelopmentAuto-check passed
  • Root Cause Debugging

    garrytan/gstack

    Investigates bugs, errors and stack traces in phases and requires a root-cause hypothesis to be confirmed before any fix is written.

    136k GitHub stars~1.4k tokensUpdated today
    DevelopmentAuto-check passed
  • Graph-Based Bug Tracing

    tirth8205/code-review-graph

    Traces a bug through a code knowledge graph, following callers, callees and execution flow before opening source files, within a small token budget.

    32k GitHub starsUsed in 1 repo~287 tokens
    DevelopmentAuto-check passed
  • Om Auto Fix Issue

    go-musicfox/go-musicfox

    Fix or implement a tracker issue end to end from a single command — takes an issue id or a plain problem description (filed first via om-prepare-issue), classifies, then drives the bug autofix chain…

    2.6k GitHub starsUsed in 1 repo~5k tokens
    DevelopmentAuto-check: notes

More from revfactory/harness-100

All 464 skills in this repo
  • Anti Bot Analyzer

    revfactory/harness-100

    A skill for analyzing website anti-bot defense mechanisms and developing legitimate evasion strategies.

    1.3k GitHub stars~1.1k tokensUpdated 6 mo ago
    Auto-check passed
  • API Error Design Patterns

    revfactory/harness-100

    Reference for designing how an API reports failures: structured error codes, response shapes, client-friendly messages, an error catalog and retry or fallback advice.

    1.3k GitHub stars~1.6k tokensUpdated 6 mo ago
    Auto-check passed
  • API Security Checklist

    revfactory/harness-100

    Walks a backend-dev agent through OWASP API Top 10 checks, authentication and authorization patterns, and defense code during API design.

    1.3k GitHub stars~1.7k tokensUpdated 6 mo ago
    Auto-check passed
  • Arg Parser Generator

    revfactory/harness-100

    Methodology for systematically designing and generating CLI tool argument parser structures.

    1.3k GitHub stars~1.2k tokensUpdated 6 mo ago
    Auto-check passed
  • Audience Segmentation

    revfactory/harness-100

    Audience segmentation skill used by the analyst and curator agents.

    1.3k GitHub stars~1.3k tokensUpdated 6 mo ago
    Auto-check passed
  • Audio Storytelling

    revfactory/harness-100

    Audio storytelling skill used by the podcast scriptwriter and show note editor.

    1.3k GitHub stars~1.6k tokensUpdated 6 mo ago
    Auto-check passed

Categories

Questions about Rca Methodology

What does Rca Methodology do?

Detailed guide for Root Cause Analysis (RCA) methodologies. An agent skill from revfactory/harness-100. Rca Methodology is an agent skill from revfactory/harness-100. Detailed guide for Root Cause Analysis (RCA) methodologies.

When should I use Rca Methodology?

Rca Methodology fits situations like: root cause analysis; cause analysis methodology; change analysis; other incident cause analysis tasks.

How do I install Rca Methodology in Claude Code?

Run `npx skills add revfactory/harness-100 --skill rca-methodology -a claude-code`. Or copy the skill folder (en/25-incident-postmortem/.claude/skills/rca-methodology in revfactory/harness-100) into .claude/skills/rca-methodology in your project. Claude Code loads it when a task matches its description.

How do I install Rca Methodology in Codex?

Run `npx skills add revfactory/harness-100 --skill rca-methodology -a codex`. Or copy the skill folder (en/25-incident-postmortem/.claude/skills/rca-methodology in revfactory/harness-100) into .agents/skills/rca-methodology in your project. Codex loads it when a task matches its description.

Can I use Rca Methodology in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add revfactory/harness-100 --skill rca-methodology -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/rca-methodology, .gemini/skills/rca-methodology, .github/skills/rca-methodology and .opencode/skills/rca-methodology in your project.

What does Rca Methodology need to run?

SKILL.md names no scripts, command-line tools or credentials: Rca Methodology is instructions for the agent only.

Does Rca Methodology access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Rca Methodology safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Rca Methodology use?

Rca Methodology is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Rca Methodology use?

About 1.5k tokens (SKILL.md is roughly 6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Rca Methodology?

Skills that share tags, products or a category with Rca Methodology: Code Design Rationale Investigator (cursor/plugins, 10k stars), OpenLogi macOS Permissions Triage (AprilNEA/OpenLogi, 23k stars), Bug Finder for daisyUI (saadeghi/daisyui, 43k stars) and Root Cause Debugging (garrytan/gstack, 136k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Rca Methodology?

revfactory (a GitHub user) maintains it in revfactory/harness-100, which has 1,290 GitHub stars. The repository holds 464 skills in this directory. The repository was last updated on March 22, 2026.

Source: revfactory/harness-100 on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.