Root-Cause Pareto

SkillMonitoring & ops

root-cause-pareto is a skill that lets your agent build a Pareto chart for downtime, defects, complaints or delays. It ranks categories so you can see which few causes account for most of the problem. The skill keeps units of measure consistent, cleans up categories, normalizes by exposure and adds a follow-up metric.

Use Root-Cause Pareto in Claude, ChatGPT or Ahel Desktop

Free. Sign in, add Root-Cause Pareto and connect your AI. About a minute.

Also: Claude Code · Cursor · Codex

Then ask your AI: use the Root-Cause Pareto skill

Details

Instructions available. Your AI can read the instructions. Execution depends on the setup they require.

Have your data ready with a clear count or duration column and a category column.

Root-Cause ParetoStart free

What your AI can do with it

  • Build a Pareto chart that ranks downtime, defects, complaints or delays
  • Enforce unit-of-measure discipline across all categories
  • Clean up and merge inconsistent category labels
  • Normalize counts by exposure such as hours or units produced
  • Add a follow-up metric to track the top cause after action

Getting started

  1. Have your data ready with a clear count or duration column and a category column.
  2. Add the skill to your agent's available skills or configuration.
  3. Ask the agent to run a Pareto analysis on your dataset.
  4. Review the ranked chart and the follow-up metric the agent returns.

What this skill tells your AI

The instructions your AI receives, as published by davila7/claude-code-templates in cli-tool/components/skills/operations/root-cause-pareto/SKILL.md and read by ahel’s review.

A Pareto chart is easy; a Pareto that survives challenge in a management meeting is not. The difference is four disciplines applied before the chart exists.

Workflow

  1. Pick the unit of measure deliberately. Occurrences, minutes, or money - choose the one closest to the pain being managed and say why. Ranking breakdowns by count when one category costs 10x more minutes per event points the team at the wrong problem. When in doubt, show count and impact side by side.
  2. Enforce category hygiene before counting:
    • Categories must sit at one granularity level (no "Mechanical failure" next to "Sensor S-114 misaligned")
    • "Other/Miscellaneous" must stay under ~15% of the total; if it is bigger, the categorization failed - split it before proceeding
    • Merge synonyms and near-duplicates (free-text logs always contain them; list the merges made)
  3. Normalize by exposure before comparing. Line A with 3 shifts will "lead" any raw ranking against Line B with 1 shift. Divide by machine-hours, orders, or units produced when comparing across lines, shifts, or periods - state the exposure base used.
  4. Check stability. A Pareto from one bad week is an anecdote. Compare the ranking across at least two comparable periods; only categories that stay on top deserve investment. Note rank changes.
  5. Rank, plot, and go one level deeper on the #1 category. Break the top category into its own sub-Pareto or apply 5-why prompts to its most frequent instances. The actionable cause is usually one level below the headline category.
  6. Define the counter-metric. Before recommending an action, state which number should move, by roughly how much, and when to re-measure. A Pareto without a follow-up measurement is decoration.

Pitfalls to check explicitly

  • Unit mismatch (count vs duration vs cost) silently reordering priorities
  • Unnormalized cross-line comparisons
  • "Other" as the tallest bar
  • Categories mixing symptoms ("stopped") with causes ("no material")
  • Acting on unstable rankings from short windows

Output format

  1. One sentence: unit of measure, exposure base, period, and total impact covered
  2. The ranked table (category, impact, share, cumulative) - chart optional, table mandatory
  3. Sub-analysis of the top category with candidate root causes
  4. Recommended action + counter-metric + re-measure date
  5. Data notes: merges performed, rows excluded, Other%

Source: industrial-engineering-ai-skills by Eren Gulmez (MIT). The full method pack - entry skill, role agents, data-hygiene rules and artifact templates - lives there.

Signals

GitHub stars
32k
Forks
4k
Last commit
Oct 2026

Questions

What is a Pareto analysis?
A Pareto analysis ranks causes by frequency or impact to show which few account for most of the problem. This skill builds that ranking for downtime, defects, complaints or delays.
What does unit-of-measure discipline mean?
It means all categories in the Pareto use the same unit, such as minutes or counts, so the ranking is valid. The skill enforces this before building the chart.
Can it normalize by exposure?
Yes. The skill normalizes counts by exposure, such as hours run or units produced, so categories with different opportunity levels are compared fairly.
Does it add a follow-up metric?
Yes. After ranking, the skill adds a follow-up metric to track whether the top cause improves after action.
Advanced
Item type
skill
Key
root-cause-pareto
Source
github.com/davila7/claude-code-templates