Failure Mode Rank

Ranks the likely failure modes for a fault against the failure-mode library, symptoms, alarm codes and repeat-failure history, deterministically. Use when the user says "what's the likely cause", "rank the failure modes", "diagnose this fault", "is this the real root cause?", or after history-retrieve completes. Do NOT use for intake — use fault-intake; history retrieval — use history-retrieve; priority — use criticality-rank; drafting — use work-order-update.

110 stars 122 forksSoftware DevelopmentOfficial

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add microsoft/cat-agent-skills --skill failure-mode-rank
Manual install
git clone --depth 1 https://github.com/microsoft/cat-agent-skills.git /tmp/cat-agent-skills
mkdir -p ~/.claude/skills
cp -r /tmp/cat-agent-skills/submissions/maintenance-triage/failure-mode-rank ~/.claude/skills/failure-mode-rank

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Failure-Mode Rank

## Purpose
Deterministically rank the candidate failure modes for the fault, matching symptoms and
alarm codes to the failure-mode library and applying the repeat-failure root-cause
promotion rule.

## When to use
- After history-retrieve, in every triage run.
- "What's the likely cause?" / "rank the failure modes" / "is the reset masking something?".

## Inputs
- The contract payload with `symptoms[]`, `alarm_codes[]`, and `history{}`
  (contract `mfg.maintenance-triage.v1`).

## Steps
1. Validate the payload against the contract.
2. Run `scripts/fault_rank.py --intake fault-intake.json --out ranked-causes.json`.
3. Do not restate or recompute any score in prose; quote the engine output verbatim.
4. Emit the `{ranked_causes}` contract payload.

## Output
Contract `mfg.maintenance-triage.v1` with populated `ranked_causes[]` (rank, failure_mode,
match_score, evidence, recommended_fix, confidence, source=engine:fault_rank, citation) and
`history.repeat_promotion` — the `{ranked_causes}` hop.

## Grounding requirements
Every ranked cause carries its OEM manual / library citation; the promotion of a root cause
over a symptomatic fix cites `references/failure-mode-library.md` #3.1.

## Constraints
- All ranking math happens in the engine. The model must never re-rank causes itself.
Read the full skill on GitHub

Details

Skill name
failure-mode-rank
Path
submissions/maintenance-triage/failure-mode-rank/SKILL.md
License
MIT
Repo updated
15 November 2026

FAQ

What does the Failure Mode Rank skill do?

Ranks the likely failure modes for a fault against the failure-mode library, symptoms, alarm codes and repeat-failure history, deterministically. Use when the user says "what's the likely cause", "rank the failure modes", "diagnose this fault", "is this the real root cause?", or after history-retrieve completes. Do NOT use for intake — use fault-intake; history retrieval — use history-retrieve; priority — use criticality-rank; drafting — use work-order-update.

How do I install the Failure Mode Rank skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add microsoft/cat-agent-skills --skill failure-mode-rank. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Failure Mode Rank popular?

It lives in microsoft/cat-agent-skills, which has 110 GitHub stars and 122 forks.

Related skills

3 Statements

110

microsoft/cat-agent-skills

Completes existing income statement, balance sheet and cash flow templates while preserving layout, grounding historical inputs and linking forecast formulas with reconciliation checks. Use for "fill in a 3-statement template", "complete an IS/BS/CF framework", "populate my integrated financial model", "link statements in this template", or "finish the forecasts in my three-statement workbook". Do NOT use for blank-slate models or general workbook edits (use xlsx), DCF valuation (use dcf-valuation), or buyout modeling (use lbo-model).

AI, LLMs & Agents122

Accessibility Pass

110

microsoft/cat-agent-skills

Use this skill whenever the user asks to check, review, or fix the accessibility of a PowerPoint deck, Word document, HTML page, or Markdown file, and before handing over any deck or document this agent just generated, so it does not ship with missing alt text, untitled slides, or unreadable colour contrast.

Frontend & Design122

Accessible Learning Materials

110

microsoft/cat-agent-skills

Maintains instructionally equivalent, accessible variants of a set of learning materials — lessons, readings, slides, and handouts — with parity checks against the original learning goals and recorded approvals. Use when the user asks to "make these materials accessible", "audit this lesson set for accessibility", "create an accessible version of this reading", "check reading level and alt text", or "keep my accessible variants in sync". Do NOT use for individual student accommodation or support-plan decisions (IEP, EHCP, or local equivalent), and do NOT use for generic document formatting (us

Learning & Education122

Gate Check

110

microsoft/cat-agent-skills

Runs the explicit Govern step: deterministic gate_check and severity_rank set gate results, release blockers and review status. Use after assertion-map or when the user asks "run the quality gate", "what blocks client issue?", "can this go to the client?", "rank the review findings", "check required reliance language" or "list the release blockers". Do NOT use for ingesting documents (use deliverable-ingest), retrieving criteria (use criteria-retrieve), mapping assertion support (use assertion-map), the packet narrative (use review-packet), time or expense narratives (use time-expense-narrativ

Software Development122

Denial Classify

110

microsoft/cat-agent-skills

Parses a post-service denial letter or remittance (X12 835 / EOB) into denial type, CARC/RARC reason codes, amounts and appeal level, with every field cited to its source. Use when asked "we got a denial from Contoso", "what kind of denial is this", "read this remittance / EOB / 835", "why was this claim denied", "start an appeal on claim CLM-10021". Use at the start of every denials-and-appeals run. Do NOT use for pre-service prior-authorization denials - use the prior-auth-assist plugin instead; do NOT use to draft or redraft the appeal letter - use appeal-draft instead; do NOT use to pull c

Software Development122

Guideline Check

110

microsoft/cat-agent-skills

Checks drafted, coded time narratives against the client billing guidelines with the deterministic guideline_check engine: block billing, prohibited or vague terms, minimum detail, non-billable work, duplicates, increments and unrecorded time. Use it after code-map, or directly, when the user asks "will this narrative get rejected?", "is my time compliant?", "catch block billing", "find prohibited terms" or "find my missing time". Do NOT use for drafting or rewriting narratives (use narrative-draft), building the manager-facing exception packet (use exception-report), approving, submitting or

Software Development122

Browse the most popular Claude skills, all software development skills, or write your own with the skills generator.