FMEA/FMECA Skill
Produce consulting-grade Failure Mode and Effects Analysis (FMEA) and Failure Mode, Effects, and
Criticality Analysis (FMECA) outputs. This skill supports five workflows: interpreting existing
analyses, authoring new ones, reviewing/critiquing quality, generating formatted deliverables, and
parsing technical documents into reusable FMECA context files.
Reference Files
Read the appropriate reference files from references/ BEFORE doing substantive work. This is
essential — the reference libraries contain domain-specific failure mode knowledge that prevents
hallucination and ensures technical accuracy.
| File |
When to read |
references/standards-guide.md |
Always read first — covers IEC 60812, SAE J1739, MIL-STD-1629A, ISO 14224 |
references/scoring-scales.md |
When assigning or reviewing severity, occurrence, detection, or criticality scores |
references/rolling-stock-taxonomy.md |
When the asset is rail/tram/train related |
references/ports-marine-taxonomy.md |
When the asset is port, wharf, marine, or shipping related |
references/mining-resources-taxonomy.md |
When the asset is mining, processing, or resources related |
references/general-industrial-taxonomy.md |
Cross-sector equipment (pumps, motors, valves, HVAC, electrical, civil) |
references/context-file-template.md |
When parsing a document into a context file (Workflow 5) |
references/{client}-*-context.md |
Client-specific context files generated by Workflow 5 — read when working on that client/asset |
For any given task, read the standards guide plus the relevant sector taxonomy. If client-specific
context files exist for the asset being analysed, read those too — they contain parsed equipment
hierarchies, operating context, failure history, and maintenance regimes extracted from real
client documentation and will significantly improve analysis quality.
Core Concepts
FMEA identifies failure modes, their effects on system performance, and existing controls.
Typically uses Risk Priority Number (RPN = Severity × Occurrence × Detection) to prioritise action.
FMECA extends FMEA with formal criticality assessment — either qualitative (criticality ranking
matrix) or quantitative (criticality number using failure rate and failure mode ratio data per
MIL-STD-1629A). FMECA is standard in defence and heavy industry.
The Hierarchy
Every FMEA/FMECA is built on a consistent decomposition:
System (e.g. Tram Braking System)
└── Sub-system (e.g. Friction Brake)
└── Component/Maintainable Item (e.g. Brake Pad Assembly)
└── Function (e.g. Convert kinetic energy to heat via friction)
└── Functional Failure (e.g. Unable to generate braking force)
└── Failure Mode (e.g. Brake pad worn below minimum thickness)
├── Failure Effect (local / system / end effect)
└── Failure Cause/Mechanism (e.g. Normal abrasive wear)
This hierarchy is non-negotiable — every analysis must trace from system context down to failure
modes. If a user provides data that skips levels, flag the gaps.
Key Distinctions
- Failure mode vs failure cause: A failure mode is the observable manner of failure ("bearing
seized"). A failure cause/mechanism is why it happened ("loss of lubrication due to seal
degradation"). Many poor FMEAs conflate these.
- Local effect vs system effect vs end effect: Effects cascade upward. Local = at the
component. System = at the sub-system/system. End = what operator/customer/public experiences.
- Evident vs hidden failure: Evident failures are apparent to operators under normal
conditions. Hidden failures (typically protective devices) only become apparent when demanded.
Discovery Process
Before starting any workflow, conduct a discovery interview. Tailor depth to the workflow.
Essential Questions (all workflows)
What asset/system are we analysing?
- Equipment type, make/model if known
- Operating context (where, how, how hard)
- Sector (rail, port, mining, other)
What's the purpose of this analysis?
- Regulatory/compliance requirement
- Maintenance strategy development (RCM-adjacent)
- Design review / DFMEA
- Risk assessment for decision-making
- Insurance or safety case input
What standard should we align to?
- IEC 60812 (default — broadest applicability)
- SAE J1739 (if automotive or rolling stock design-focused)
- MIL-STD-1629A (if defence or quantitative criticality required)
- ISO 14224 (if petroleum/gas or aligning to that failure taxonomy)
- Client-specific methodology (ask for details)
What data is available?
- Existing FMEAs or maintenance strategies
- Asset registers or BOMs
- Failure/work order history
- OEM manuals or maintenance documentation
- P&IDs, schematics, or system diagrams
Additional Questions by Workflow
For authoring: Level of detail expected? How many equipment items? System-level or
component-level? Who reviews?
For review: What concerns prompted the review? Known gaps? Consequence of errors?
For outputs: What format does the client expect? Do they have a template? What scoring scale?
Workflow 1: Interpret & Explain
When a user uploads or pastes FMEA/FMECA data and wants to understand it.
Parse the input — Identify structure, columns, scoring method, hierarchy depth, standard
alignment. Note what's present and what's missing.
Summarise the scope — What system/asset, how many failure modes, what scoring method, what
standard it appears to follow.
Explain the findings — In plain language: highest-risk items, what scores mean practically,
hidden failures, common-cause failures, recommended actions.
Flag quality issues — Missing data, inconsistent scoring, vague descriptions, missing
hierarchy levels. Even when interpreting, note these.
Provide context — Relate findings to operating context. A high RPN on a tram braking
component has different urgency than on a warehouse HVAC unit.
Lead with the "so what" — what should the reader care about and do next.
Workflow 2: Author from Scratch
When building a new FMEA/FMECA from available data.
Establish the system boundary — What's in scope and out. Define top-level system and
interfaces.
Build the hierarchy — Use the appropriate sector taxonomy from references/ as a starting
point. Decompose to maintainable item level (the level at which you'd write a work order).
Define functions — State what each component does in quantifiable terms where possible.
"Maintain hydraulic pressure at 200 bar" not "Works properly". Every item needs at least one
function.
Identify functional failures — For each function: total loss, partial loss, intermittent
loss, degraded performance, unintended function, over-function.
Determine failure modes — Specific, observable manners of failure. Use taxonomy references
as a prompt but adapt to the specific asset. Quality test: could a technician read this and
picture exactly what's wrong?
- Good: "Impeller blades eroded reducing flow by >20%"
- Bad: "Pump degraded"
Describe failure effects — At three levels (local, system, end). Include secondary damage,
safety implications, environmental consequences.
Identify failure causes/mechanisms — What initiates or drives each failure mode. Link to
operating context. Multiple causes per failure mode is normal.
Assess severity, occurrence, and detection — Read references/scoring-scales.md. Apply
consistently. Document assumptions.
Calculate RPN or criticality — Per the selected standard.
Recommend actions — For high-priority items: preventive tasks (with intervals), condition
monitoring, design modifications, redundancy, operational changes, or risk acceptance with
justification.
Quality Checks During Authoring
Run continuously, not just at the end:
- Every component has at least one function stated
- Every function has at least one functional failure
- Every functional failure has at least one failure mode
- Failure modes are specific and observable
- Effects cascade correctly (local → system → end)
- Causes are distinct from failure modes
- Scoring is consistent across similar items
- No orphaned rows (failure modes without effects or causes)
Workflow 3: Review & Critique
Score each dimension 1–5 and provide specific findings:
Structural completeness — Hierarchy complete? Functions stated? Orphaned entries?
Failure mode quality — Specific and observable? Common modes covered? (Cross-reference
against sector taxonomy.) Cause-mode confusion?
Effects analysis quality — All three levels described? Safety/environmental consequences
addressed? Cascading effects considered?
Scoring consistency — Scale documented? Similar modes scored consistently? Severity reflects
end effects? Detection based on current controls?
Completeness of recommendations — High-RPN items have actions? Actions specific? Clear
link between failure mode and recommended task?
Standard alignment — Format matches claimed standard? Mandatory fields present? Criticality
methodology correct?
Output: Structured review report
- Executive summary (overall quality rating, key concerns)
- Findings by dimension (with specific examples)
- Priority recommendations (what to fix first)
- Positive observations (what's done well)
Workflow 4: Generate Outputs
Spreadsheet (.xlsx)
Use the xlsx skill. Structure columns per selected standard:
IEC 60812 / general FMEA columns:
Item | Function | Functional Failure | Failure Mode | Failure Cause | Local Effect | System Effect |
End Effect | Severity | Occurrence | Detection | RPN | Recommended Action | Responsible | Target
Date | Status
MIL-STD-1629A FMECA columns:
Item ID | Item Name | Function | Failure Mode | Failure Cause | Mission Phase | Local Effect |
Next Higher Effect | End Effect | Severity Class | Failure Rate | Mode Ratio | Criticality Number |
Compensating Provisions | Remarks
SAE J1739 columns:
Item/Function | Potential Failure Mode | Potential Effect(s) | Severity | Class | Potential Cause(s) |
Occurrence | Current Prevention Controls | Current Detection Controls | Detection | RPN |
Recommended Action | Responsibility | Target Date | Action Taken | Revised S | Revised O |
Revised D | Revised RPN
Other Formats
- Risk matrix — HTML artifact: severity × occurrence heat map showing failure mode distribution
- Summary report (.docx) — Executive-level: scope, methodology, findings, risk profile, recommendations
- FMECA register (.xlsx) — Full register with filtering, conditional formatting, summary dashboard
Formatting Standards
- Conditional formatting on RPN/criticality (Red/Amber/Green thresholds)
- Legend/key sheet explaining scoring scales
- Summary sheet with counts by risk category
- Frozen headers, auto-filter enabled
- Appropriate column widths
Workflow 5: Parse Document into FMECA Context File
When a user uploads a technical document and wants to extract FMECA-relevant information into a
structured markdown file for reuse in future sessions.
This workflow is foundational — it turns raw client/OEM documentation into a machine-readable
reference that dramatically improves the quality of subsequent FMEA/FMECA work. The output .md file
is saved directly into the skill's references/ directory so it's automatically available in
future sessions alongside the sector taxonomies.
Supported Document Types
Parse any of these into a context file. Each type yields different information — extract what's
present and flag what's missing:
| Document Type |
What to Extract |
| OEM/Maintenance Manual |
Equipment hierarchy, functions, component specs, recommended maintenance, operating limits, OEM-specified failure modes |
| Asset Register / BOM |
Equipment hierarchy, item naming conventions, parent-child relationships, quantities, criticality tags if present |
| Maintenance Plan / Strategy |
Current PM tasks, task intervals, condition monitoring, shutdown scope, maintenance philosophy |
| P&ID / System Diagram |
System boundaries, equipment arrangement, process flow, instrumentation, protective devices, redundancy |
| Inspection / Condition Report |
Current condition state, identified defects, degradation rates, remaining life estimates, photos/measurements |
| Failure History / Work Orders |
Actual failure modes experienced, frequency, root causes, downtime, repair actions, repeat failures |
| Existing FMEA/FMECA |
Previous analysis scope, scoring methodology, identified failure modes, recommended actions, gaps |
| Safety Case / HAZOP |
Identified hazards, consequences, safeguards, SIL ratings, safety-critical items |
| Operating Procedures |
Operating modes, start-up/shutdown sequences, abnormal operating conditions, operator interventions |
| Reliability Data / Reports |
Failure rates, MTBF, MTTR, availability, reliability distributions, Weibull parameters |
Process
Read the document — Use the appropriate tool to access the uploaded file. For PDFs, extract
text. For spreadsheets, parse the structure. For images of P&IDs or diagrams, describe what's
visible.
Read the context file template — Read references/context-file-template.md for the output
structure. This is the target format.
Identify the document type — Determine which type(s) from the table above. A single document
may span multiple types (e.g. an OEM manual contains both equipment specs and maintenance
recommendations).
Extract and structure — Pull out all FMECA-relevant information and organise it into the
template sections. Be thorough — it's better to capture something that turns out to be
marginally useful than to miss something critical.
Cross-reference against taxonomy — Compare the extracted equipment hierarchy against the
relevant sector taxonomy. Note where the document's naming differs from standard taxonomy terms
(this mapping is valuable for future work).
Flag gaps and uncertainties — At the end of the context file, explicitly list:
- Information that was expected but not found in the document
- Ambiguous items where interpretation was required
- Areas where additional documents would significantly improve the context
- Any conflicts between the document and standard taxonomies
Name the file descriptively — Use the pattern:
{client}-{asset}-{doctype}-context.md
Examples: yarratrams-bclass-oem-context.md, geelongport-shiploader1-condition-context.md,
santos-compressor-fmea-context.md
Save to the skill's references directory — Write the context file directly into the FMECA
skill's references directory so it's automatically available in future sessions:
Claude Code / Agent SDK (filesystem-based skills):
Save to the project or user skill path, whichever contains the fmeca skill:
.claude/skills/fmeca/references/{client}-{asset}-{doctype}-context.md
If the project path (.claude/skills/fmeca/) doesn't exist, fall back to the user path:
~/.claude/skills/fmeca/references/{client}-{asset}-{doctype}-context.md
Claude.ai (container environment):
The container filesystem resets between sessions, so save to both locations:
- Working location:
/mnt/skills/user/fmeca/references/ (if writable) or the skill's own
references directory
- Download copy:
/mnt/user-data/outputs/ so the user can manually add it to their skill
directory outside the session
Confirm with the user before saving. State the full file path and ask them to confirm.
If the references directory doesn't exist yet, create it.
Register in the reference table — After saving, remind the user to add an entry to the
SKILL.md reference table so the context file gets loaded in future sessions when relevant.
Suggest the entry in this format:
| `references/{filename}.md` | When working on {client} {asset} FMECA |
If running in Claude Code with write access to SKILL.md, offer to add the entry directly.
Extraction Rules
These rules ensure consistency across context files regardless of who creates them:
Equipment Hierarchy
- Decompose to the maintainable item level (the level a technician would write a work order against)
- Use the document's own naming where it exists, but add standard taxonomy mapping in parentheses
where terms differ. E.g. "Traction Power Module (≈ Traction Inverter per rolling-stock-taxonomy)"
- Preserve the document's item numbering/coding scheme — this is essential for traceability
Functions
- State functions in the format: verb + object + quantified performance where available
- Good: "Maintain brake pad contact pressure at 12-15 kN per caliper"
- Acceptable if doc lacks specifics: "Provide braking force to decelerate vehicle"
- Always note the source: "(per OEM Manual Section 4.3)" or "(inferred from system description)"
Operating Context
- Capture everything that affects failure behaviour: environment, duty cycle, loading,
temperature, exposure, utilisation rate
- Note seasonal or campaign-based variations
- Include any operating restrictions or limitations documented
Maintenance Context
- Capture current tasks, intervals, and the basis for those intervals (OEM recommendation,
regulatory, experience-based)
- Note where tasks are time-based vs condition-based
- Capture any documented maintenance access constraints (outage required, confined space, etc.)
Failure Information
- Record failure modes exactly as described in the source document
- Map to standard taxonomy terms where possible, but preserve the original language
- Capture any quantitative data (failure rates, MTBF, Weibull parameters) with units and source
- Note sample sizes and confidence levels where available
Protective Devices & Hidden Failures
- Explicitly list every protective device, alarm, trip, relief valve, standby system
- For each, note: what it protects against, how it's tested, test interval, last known test result
- These are the most commonly missed items in FMEAs — extracting them upfront is high-value
Combining Multiple Documents
When multiple documents relate to the same asset/system:
- Parse each document individually first, saving each to the skill's references directory
- Then create a consolidated context file that merges the information, named:
{client}-{asset}-consolidated-context.md
- Save the consolidated file to the same references directory — it replaces the individual files
as the primary reference for that asset (keep the individual files for traceability)
- Where documents conflict (e.g. OEM says 500hr service interval, maintenance plan says 750hr),
note both values and the source of each — don't silently pick one
- The consolidated file should cross-reference source documents for traceability:
"[Source: OEM Manual Rev C, Section 4.3.2]"
- Update the SKILL.md reference table entry to point to the consolidated file
Output Quality Check
Before finalising the context file, verify:
- Every equipment item has at least one function stated (or flagged as "function not documented")
- The hierarchy is internally consistent (no orphaned items, no gaps between levels)
- Operating context section is populated (even if sparse — note what's missing)
- Protective devices section is populated (or explicitly states "no protective devices identified")
- Source references are traceable to specific sections/pages of the input document
- The gaps/uncertainties section is honest and actionable
General Guidance
Common Pitfalls to Flag
- Vague failure modes — "Component fails" is not a failure mode
- Cause-mode confusion — "Corrosion" is usually a cause, not a mode
- Inconsistent scoring — Same failure type scored differently without justification
- Missing hidden failures — Protective devices frequently missed
- Single-point-of-failure blindness — Not identifying absent redundancy
- Copy-paste syndrome — Generic descriptions reused without adaptation
- Detection score confusion — Rates current controls, not theoretical capability
- Severity creep — Everything rated 9-10 makes analysis useless for prioritisation
- Missing operating context — Same equipment, different environment = different failure behaviour
When Data is Insufficient
Be transparent. State assumptions clearly. Flag where engineering judgement has been applied vs
data-supported assessment. Recommend data collection for critical gaps. Never fabricate failure
rate data — use qualitative ranges and state the basis.
Integration
This skill works with: xlsx skill (worksheets), docx skill (reports), pptx/presentation skills
(stakeholder presentations). Read the relevant output skill first, then apply FMECA domain knowledge.
1---2name: fmeca3description: Analyse, author, review, generate, and extract context for FMEA and FMECA documents for asset-intensive organisations. Use this skill whenever the user mentions FMEA, FMECA, failure mode, failure effects, failure analysis, criticality analysis, RPN, risk priority number, severity-occurrence-detection scoring, functional failure, failure cause analysis, or maintenance strategy development based on failure analysis. Also trigger when the user uploads a spreadsheet or document that appears to contain failure mode data, or asks about reliability-centred maintenance (RCM) failure analysis steps, or wants to develop maintenance tasks from equipment failure behaviour. Also trigger when users ask about equipment functions, functional failures, failure consequences, or hidden vs evident failures. Also trigger when the user asks to parse, extract, or read a technical document (OEM manual, maintenance plan, asset register, BOM, P&ID, inspection report, condition assessment) for FMECA context, or asks to build a context 4---5
6# FMEA/FMECA Skill
7
8Produce consulting-grade Failure Mode and Effects Analysis (FMEA) and Failure Mode, Effects, and
9Criticality Analysis (FMECA) outputs. This skill supports five workflows: interpreting existing
10analyses, authoring new ones, reviewing/critiquing quality, generating formatted deliverables, and
11parsing technical documents into reusable FMECA context files.
12
13## Reference Files
14
15Read the appropriate reference files from `references/` BEFORE doing substantive work. This is
16essential — the reference libraries contain domain-specific failure mode knowledge that prevents
17hallucination and ensures technical accuracy.
18
19| File | When to read |
20|------|-------------|
21| `references/standards-guide.md` | Always read first — covers IEC 60812, SAE J1739, MIL-STD-1629A, ISO 14224 |
22| `references/scoring-scales.md` | When assigning or reviewing severity, occurrence, detection, or criticality scores |
23| `references/rolling-stock-taxonomy.md` | When the asset is rail/tram/train related |
24| `references/ports-marine-taxonomy.md` | When the asset is port, wharf, marine, or shipping related |
25| `references/mining-resources-taxonomy.md` | When the asset is mining, processing, or resources related |
26| `references/general-industrial-taxonomy.md` | Cross-sector equipment (pumps, motors, valves, HVAC, electrical, civil) |
27| `references/context-file-template.md` | When parsing a document into a context file (Workflow 5) |
28| `references/{client}-*-context.md` | Client-specific context files generated by Workflow 5 — read when working on that client/asset |
29
30For any given task, read the standards guide plus the relevant sector taxonomy. If client-specific
31context files exist for the asset being analysed, read those too — they contain parsed equipment
32hierarchies, operating context, failure history, and maintenance regimes extracted from real
33client documentation and will significantly improve analysis quality.
34
35---
36
37## Core Concepts
38
39**FMEA** identifies failure modes, their effects on system performance, and existing controls.
40Typically uses Risk Priority Number (RPN = Severity × Occurrence × Detection) to prioritise action.
41
42**FMECA** extends FMEA with formal criticality assessment — either qualitative (criticality ranking
43matrix) or quantitative (criticality number using failure rate and failure mode ratio data per
44MIL-STD-1629A). FMECA is standard in defence and heavy industry.
45
46### The Hierarchy
47
48Every FMEA/FMECA is built on a consistent decomposition:
49
50```
51System (e.g. Tram Braking System)
52 └── Sub-system (e.g. Friction Brake)
53 └── Component/Maintainable Item (e.g. Brake Pad Assembly)
54 └── Function (e.g. Convert kinetic energy to heat via friction)
55 └── Functional Failure (e.g. Unable to generate braking force)
56 └── Failure Mode (e.g. Brake pad worn below minimum thickness)
57 ├── Failure Effect (local / system / end effect)
58 └── Failure Cause/Mechanism (e.g. Normal abrasive wear)
59```
60
61This hierarchy is non-negotiable — every analysis must trace from system context down to failure
62modes. If a user provides data that skips levels, flag the gaps.
63
64### Key Distinctions
65
66- **Failure mode** vs **failure cause**: A failure mode is the observable manner of failure ("bearing
67 seized"). A failure cause/mechanism is why it happened ("loss of lubrication due to seal
68 degradation"). Many poor FMEAs conflate these.
69- **Local effect** vs **system effect** vs **end effect**: Effects cascade upward. Local = at the
70 component. System = at the sub-system/system. End = what operator/customer/public experiences.
71- **Evident** vs **hidden failure**: Evident failures are apparent to operators under normal
72 conditions. Hidden failures (typically protective devices) only become apparent when demanded.
73
74---
75
76## Discovery Process
77
78Before starting any workflow, conduct a discovery interview. Tailor depth to the workflow.
79
80### Essential Questions (all workflows)
81
821. **What asset/system are we analysing?**
83 - Equipment type, make/model if known
84 - Operating context (where, how, how hard)
85 - Sector (rail, port, mining, other)
86
872. **What's the purpose of this analysis?**
88 - Regulatory/compliance requirement
89 - Maintenance strategy development (RCM-adjacent)
90 - Design review / DFMEA
91 - Risk assessment for decision-making
92 - Insurance or safety case input
93
943. **What standard should we align to?**
95 - IEC 60812 (default — broadest applicability)
96 - SAE J1739 (if automotive or rolling stock design-focused)
97 - MIL-STD-1629A (if defence or quantitative criticality required)
98 - ISO 14224 (if petroleum/gas or aligning to that failure taxonomy)
99 - Client-specific methodology (ask for details)
100
1014. **What data is available?**
102 - Existing FMEAs or maintenance strategies
103 - Asset registers or BOMs
104 - Failure/work order history
105 - OEM manuals or maintenance documentation
106 - P&IDs, schematics, or system diagrams
107
108### Additional Questions by Workflow
109
110**For authoring**: Level of detail expected? How many equipment items? System-level or
111component-level? Who reviews?
112
113**For review**: What concerns prompted the review? Known gaps? Consequence of errors?
114
115**For outputs**: What format does the client expect? Do they have a template? What scoring scale?
116
117---
118
119## Workflow 1: Interpret & Explain
120
121When a user uploads or pastes FMEA/FMECA data and wants to understand it.
122
1231. **Parse the input** — Identify structure, columns, scoring method, hierarchy depth, standard
124 alignment. Note what's present and what's missing.
125
1262. **Summarise the scope** — What system/asset, how many failure modes, what scoring method, what
127 standard it appears to follow.
128
1293. **Explain the findings** — In plain language: highest-risk items, what scores mean practically,
130 hidden failures, common-cause failures, recommended actions.
131
1324. **Flag quality issues** — Missing data, inconsistent scoring, vague descriptions, missing
133 hierarchy levels. Even when interpreting, note these.
134
1355. **Provide context** — Relate findings to operating context. A high RPN on a tram braking
136 component has different urgency than on a warehouse HVAC unit.
137
138Lead with the "so what" — what should the reader care about and do next.
139
140---
141
142## Workflow 2: Author from Scratch
143
144When building a new FMEA/FMECA from available data.
145
1461. **Establish the system boundary** — What's in scope and out. Define top-level system and
147 interfaces.
148
1492. **Build the hierarchy** — Use the appropriate sector taxonomy from `references/` as a starting
150 point. Decompose to maintainable item level (the level at which you'd write a work order).
151
1523. **Define functions** — State what each component does in quantifiable terms where possible.
153 "Maintain hydraulic pressure at 200 bar" not "Works properly". Every item needs at least one
154 function.
155
1564. **Identify functional failures** — For each function: total loss, partial loss, intermittent
157 loss, degraded performance, unintended function, over-function.
158
1595. **Determine failure modes** — Specific, observable manners of failure. Use taxonomy references
160 as a prompt but adapt to the specific asset. Quality test: could a technician read this and
161 picture exactly what's wrong?
162 - Good: "Impeller blades eroded reducing flow by >20%"
163 - Bad: "Pump degraded"
164
1656. **Describe failure effects** — At three levels (local, system, end). Include secondary damage,
166 safety implications, environmental consequences.
167
1687. **Identify failure causes/mechanisms** — What initiates or drives each failure mode. Link to
169 operating context. Multiple causes per failure mode is normal.
170
1718. **Assess severity, occurrence, and detection** — Read `references/scoring-scales.md`. Apply
172 consistently. Document assumptions.
173
1749. **Calculate RPN or criticality** — Per the selected standard.
175
17610. **Recommend actions** — For high-priority items: preventive tasks (with intervals), condition
177 monitoring, design modifications, redundancy, operational changes, or risk acceptance with
178 justification.
179
180### Quality Checks During Authoring
181
182Run continuously, not just at the end:
183- Every component has at least one function stated
184- Every function has at least one functional failure
185- Every functional failure has at least one failure mode
186- Failure modes are specific and observable
187- Effects cascade correctly (local → system → end)
188- Causes are distinct from failure modes
189- Scoring is consistent across similar items
190- No orphaned rows (failure modes without effects or causes)
191
192---
193
194## Workflow 3: Review & Critique
195
196Score each dimension 1–5 and provide specific findings:
197
1981. **Structural completeness** — Hierarchy complete? Functions stated? Orphaned entries?
199
2002. **Failure mode quality** — Specific and observable? Common modes covered? (Cross-reference
201 against sector taxonomy.) Cause-mode confusion?
202
2033. **Effects analysis quality** — All three levels described? Safety/environmental consequences
204 addressed? Cascading effects considered?
205
2064. **Scoring consistency** — Scale documented? Similar modes scored consistently? Severity reflects
207 end effects? Detection based on current controls?
208
2095. **Completeness of recommendations** — High-RPN items have actions? Actions specific? Clear
210 link between failure mode and recommended task?
211
2126. **Standard alignment** — Format matches claimed standard? Mandatory fields present? Criticality
213 methodology correct?
214
215### Output: Structured review report
216- Executive summary (overall quality rating, key concerns)
217- Findings by dimension (with specific examples)
218- Priority recommendations (what to fix first)
219- Positive observations (what's done well)
220
221---
222
223## Workflow 4: Generate Outputs
224
225### Spreadsheet (.xlsx)
226
227Use the xlsx skill. Structure columns per selected standard:
228
229**IEC 60812 / general FMEA columns:**
230Item | Function | Functional Failure | Failure Mode | Failure Cause | Local Effect | System Effect |
231End Effect | Severity | Occurrence | Detection | RPN | Recommended Action | Responsible | Target
232Date | Status
233
234**MIL-STD-1629A FMECA columns:**
235Item ID | Item Name | Function | Failure Mode | Failure Cause | Mission Phase | Local Effect |
236Next Higher Effect | End Effect | Severity Class | Failure Rate | Mode Ratio | Criticality Number |
237Compensating Provisions | Remarks
238
239**SAE J1739 columns:**
240Item/Function | Potential Failure Mode | Potential Effect(s) | Severity | Class | Potential Cause(s) |
241Occurrence | Current Prevention Controls | Current Detection Controls | Detection | RPN |
242Recommended Action | Responsibility | Target Date | Action Taken | Revised S | Revised O |
243Revised D | Revised RPN
244
245### Other Formats
246
247- **Risk matrix** — HTML artifact: severity × occurrence heat map showing failure mode distribution
248- **Summary report (.docx)** — Executive-level: scope, methodology, findings, risk profile, recommendations
249- **FMECA register (.xlsx)** — Full register with filtering, conditional formatting, summary dashboard
250
251### Formatting Standards
252- Conditional formatting on RPN/criticality (Red/Amber/Green thresholds)
253- Legend/key sheet explaining scoring scales
254- Summary sheet with counts by risk category
255- Frozen headers, auto-filter enabled
256- Appropriate column widths
257
258---
259
260## Workflow 5: Parse Document into FMECA Context File
261
262When a user uploads a technical document and wants to extract FMECA-relevant information into a
263structured markdown file for reuse in future sessions.
264
265This workflow is foundational — it turns raw client/OEM documentation into a machine-readable
266reference that dramatically improves the quality of subsequent FMEA/FMECA work. The output .md file
267is saved directly into the skill's `references/` directory so it's automatically available in
268future sessions alongside the sector taxonomies.
269
270### Supported Document Types
271
272Parse any of these into a context file. Each type yields different information — extract what's
273present and flag what's missing:
274
275| Document Type | What to Extract |
276|--------------|----------------|
277| OEM/Maintenance Manual | Equipment hierarchy, functions, component specs, recommended maintenance, operating limits, OEM-specified failure modes |
278| Asset Register / BOM | Equipment hierarchy, item naming conventions, parent-child relationships, quantities, criticality tags if present |
279| Maintenance Plan / Strategy | Current PM tasks, task intervals, condition monitoring, shutdown scope, maintenance philosophy |
280| P&ID / System Diagram | System boundaries, equipment arrangement, process flow, instrumentation, protective devices, redundancy |
281| Inspection / Condition Report | Current condition state, identified defects, degradation rates, remaining life estimates, photos/measurements |
282| Failure History / Work Orders | Actual failure modes experienced, frequency, root causes, downtime, repair actions, repeat failures |
283| Existing FMEA/FMECA | Previous analysis scope, scoring methodology, identified failure modes, recommended actions, gaps |
284| Safety Case / HAZOP | Identified hazards, consequences, safeguards, SIL ratings, safety-critical items |
285| Operating Procedures | Operating modes, start-up/shutdown sequences, abnormal operating conditions, operator interventions |
286| Reliability Data / Reports | Failure rates, MTBF, MTTR, availability, reliability distributions, Weibull parameters |
287
288### Process
289
2901. **Read the document** — Use the appropriate tool to access the uploaded file. For PDFs, extract
291 text. For spreadsheets, parse the structure. For images of P&IDs or diagrams, describe what's
292 visible.
293
2942. **Read the context file template** — Read `references/context-file-template.md` for the output
295 structure. This is the target format.
296
2973. **Identify the document type** — Determine which type(s) from the table above. A single document
298 may span multiple types (e.g. an OEM manual contains both equipment specs and maintenance
299 recommendations).
300
3014. **Extract and structure** — Pull out all FMECA-relevant information and organise it into the
302 template sections. Be thorough — it's better to capture something that turns out to be
303 marginally useful than to miss something critical.
304
3055. **Cross-reference against taxonomy** — Compare the extracted equipment hierarchy against the
306 relevant sector taxonomy. Note where the document's naming differs from standard taxonomy terms
307 (this mapping is valuable for future work).
308
3096. **Flag gaps and uncertainties** — At the end of the context file, explicitly list:
310 - Information that was expected but not found in the document
311 - Ambiguous items where interpretation was required
312 - Areas where additional documents would significantly improve the context
313 - Any conflicts between the document and standard taxonomies
314
3157. **Name the file descriptively** — Use the pattern:
316 `{client}-{asset}-{doctype}-context.md`
317 Examples: `yarratrams-bclass-oem-context.md`, `geelongport-shiploader1-condition-context.md`,
318 `santos-compressor-fmea-context.md`
319
3208. **Save to the skill's references directory** — Write the context file directly into the FMECA
321 skill's references directory so it's automatically available in future sessions:
322
323 **Claude Code / Agent SDK (filesystem-based skills):**
324 Save to the project or user skill path, whichever contains the fmeca skill:
325 ```
326 .claude/skills/fmeca/references/{client}-{asset}-{doctype}-context.md
327 ```
328 If the project path (`.claude/skills/fmeca/`) doesn't exist, fall back to the user path:
329 ```
330 ~/.claude/skills/fmeca/references/{client}-{asset}-{doctype}-context.md
331 ```
332
333 **Claude.ai (container environment):**
334 The container filesystem resets between sessions, so save to both locations:
335 - Working location: `/mnt/skills/user/fmeca/references/` (if writable) or the skill's own
336 references directory
337 - Download copy: `/mnt/user-data/outputs/` so the user can manually add it to their skill
338 directory outside the session
339
340 **Confirm with the user** before saving. State the full file path and ask them to confirm.
341 If the references directory doesn't exist yet, create it.
342
3439. **Register in the reference table** — After saving, remind the user to add an entry to the
344 SKILL.md reference table so the context file gets loaded in future sessions when relevant.
345 Suggest the entry in this format:
346 ```
347 | `references/{filename}.md` | When working on {client} {asset} FMECA |
348 ```
349 If running in Claude Code with write access to SKILL.md, offer to add the entry directly.
350
351### Extraction Rules
352
353These rules ensure consistency across context files regardless of who creates them:
354
355**Equipment Hierarchy**
356- Decompose to the maintainable item level (the level a technician would write a work order against)
357- Use the document's own naming where it exists, but add standard taxonomy mapping in parentheses
358 where terms differ. E.g. "Traction Power Module (≈ Traction Inverter per rolling-stock-taxonomy)"
359- Preserve the document's item numbering/coding scheme — this is essential for traceability
360
361**Functions**
362- State functions in the format: verb + object + quantified performance where available
363- Good: "Maintain brake pad contact pressure at 12-15 kN per caliper"
364- Acceptable if doc lacks specifics: "Provide braking force to decelerate vehicle"
365- Always note the source: "(per OEM Manual Section 4.3)" or "(inferred from system description)"
366
367**Operating Context**
368- Capture everything that affects failure behaviour: environment, duty cycle, loading,
369 temperature, exposure, utilisation rate
370- Note seasonal or campaign-based variations
371- Include any operating restrictions or limitations documented
372
373**Maintenance Context**
374- Capture current tasks, intervals, and the basis for those intervals (OEM recommendation,
375 regulatory, experience-based)
376- Note where tasks are time-based vs condition-based
377- Capture any documented maintenance access constraints (outage required, confined space, etc.)
378
379**Failure Information**
380- Record failure modes exactly as described in the source document
381- Map to standard taxonomy terms where possible, but preserve the original language
382- Capture any quantitative data (failure rates, MTBF, Weibull parameters) with units and source
383- Note sample sizes and confidence levels where available
384
385**Protective Devices & Hidden Failures**
386- Explicitly list every protective device, alarm, trip, relief valve, standby system
387- For each, note: what it protects against, how it's tested, test interval, last known test result
388- These are the most commonly missed items in FMEAs — extracting them upfront is high-value
389
390### Combining Multiple Documents
391
392When multiple documents relate to the same asset/system:
393
394- Parse each document individually first, saving each to the skill's references directory
395- Then create a consolidated context file that merges the information, named:
396 `{client}-{asset}-consolidated-context.md`
397- Save the consolidated file to the same references directory — it replaces the individual files
398 as the primary reference for that asset (keep the individual files for traceability)
399- Where documents conflict (e.g. OEM says 500hr service interval, maintenance plan says 750hr),
400 note both values and the source of each — don't silently pick one
401- The consolidated file should cross-reference source documents for traceability:
402 "[Source: OEM Manual Rev C, Section 4.3.2]"
403- Update the SKILL.md reference table entry to point to the consolidated file
404
405### Output Quality Check
406
407Before finalising the context file, verify:
408- Every equipment item has at least one function stated (or flagged as "function not documented")
409- The hierarchy is internally consistent (no orphaned items, no gaps between levels)
410- Operating context section is populated (even if sparse — note what's missing)
411- Protective devices section is populated (or explicitly states "no protective devices identified")
412- Source references are traceable to specific sections/pages of the input document
413- The gaps/uncertainties section is honest and actionable
414
415---
416
417## General Guidance
418
419### Common Pitfalls to Flag
420
4211. **Vague failure modes** — "Component fails" is not a failure mode
4222. **Cause-mode confusion** — "Corrosion" is usually a cause, not a mode
4233. **Inconsistent scoring** — Same failure type scored differently without justification
4244. **Missing hidden failures** — Protective devices frequently missed
4255. **Single-point-of-failure blindness** — Not identifying absent redundancy
4266. **Copy-paste syndrome** — Generic descriptions reused without adaptation
4277. **Detection score confusion** — Rates current controls, not theoretical capability
4288. **Severity creep** — Everything rated 9-10 makes analysis useless for prioritisation
4299. **Missing operating context** — Same equipment, different environment = different failure behaviour
430
431### When Data is Insufficient
432
433Be transparent. State assumptions clearly. Flag where engineering judgement has been applied vs
434data-supported assessment. Recommend data collection for critical gaps. Never fabricate failure
435rate data — use qualitative ranges and state the basis.
436
437### Integration
438
439This skill works with: xlsx skill (worksheets), docx skill (reports), pptx/presentation skills
440(stakeholder presentations). Read the relevant output skill first, then apply FMECA domain knowledge.