failure-analysis
Systematic failure analysis methodology for mechanical component failures
Best use case
failure-analysis is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
Systematic failure analysis methodology for mechanical component failures
Teams using failure-analysis should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/failure-analysis/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How failure-analysis Compares
| Feature / Agent | failure-analysis | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
Systematic failure analysis methodology for mechanical component failures
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
SKILL.md Source
# Failure Analysis Skill
## Purpose
The Failure Analysis skill provides systematic methodology for investigating mechanical component failures, enabling root cause identification through fractography, metallography, stress analysis, and structured problem-solving approaches.
## Capabilities
- Fractography interpretation (SEM, optical)
- Metallographic examination guidance
- Root cause analysis frameworks (5-Why, Fishbone)
- Failure mode identification (fatigue, corrosion, overload)
- Stress analysis correlation to failure location
- Chemical analysis interpretation
- Corrective action development
- Failure analysis report generation
## Usage Guidelines
### Investigation Process
#### Phase 1: Evidence Preservation
1. **Documentation**
- Photograph failed components as-received
- Document orientation and assembly position
- Record operating conditions at failure
- Preserve all fragments
2. **Chain of Custody**
- Log all handling
- Secure storage
- Controlled access
- Document any cleaning or cutting
#### Phase 2: Visual Examination
1. **Macroscopic Features**
| Feature | Indication |
|---------|------------|
| Beach marks | Fatigue |
| Chevron marks | Brittle fracture |
| Shear lips | Ductile overload |
| Corrosion products | Environmental attack |
| Wear patterns | Tribological failure |
2. **Fracture Origin**
- Identify initiation site
- Look for stress concentrations
- Check for material defects
- Document surface conditions
#### Phase 3: Fractography
1. **Optical Microscopy**
- Low magnification overview
- Document fracture features
- Identify regions of interest
2. **Scanning Electron Microscopy (SEM)**
| Fracture Feature | Failure Mode |
|------------------|--------------|
| Striations | Fatigue crack growth |
| Dimples | Ductile overload |
| Cleavage facets | Brittle fracture |
| Intergranular | Creep, SCC, hydrogen |
| Quasi-cleavage | Mixed mode |
3. **EDS Analysis**
- Identify corrosion products
- Detect contamination
- Verify material composition
#### Phase 4: Metallography
1. **Sample Preparation**
- Section perpendicular to fracture
- Mount in appropriate media
- Grind and polish
- Select appropriate etchant
2. **Examination**
- Grain structure
- Heat treatment condition
- Inclusions and defects
- Microcracking
- Decarburization
### Failure Mode Identification
#### Fatigue Failure
```
Characteristics:
- Beach marks (macroscopic)
- Striations (microscopic)
- Origin at stress concentration
- Minimal plastic deformation
- Flat fracture surface
Contributing Factors:
- Cyclic loading
- Stress concentration
- Residual stress
- Material defects
- Environmental effects
```
#### Overload Failure
```
Ductile:
- Significant plastic deformation
- Cup-and-cone fracture (tensile)
- Shear lips
- Dimpled fracture surface
Brittle:
- Little plastic deformation
- Flat fracture surface
- Chevron marks pointing to origin
- Cleavage or intergranular fracture
```
#### Corrosion Failures
| Type | Characteristics | Environment |
|------|-----------------|-------------|
| Uniform | General metal loss | Acids, bases |
| Pitting | Localized attack | Chlorides |
| SCC | Branching cracks | Specific ion + stress |
| Corrosion fatigue | Accelerated fatigue | Cyclic + corrosive |
| Hydrogen embrittlement | Intergranular fracture | Hydrogen source |
#### Wear Failures
| Type | Mechanism | Evidence |
|------|-----------|----------|
| Adhesive | Material transfer | Galling, scoring |
| Abrasive | Hard particle cutting | Grooves, scratches |
| Erosive | Fluid/particle impact | Surface damage pattern |
| Fretting | Small amplitude motion | Oxide debris, pitting |
### Root Cause Analysis
#### 5-Why Method
```
Problem: Shaft failure
Why 1: Fatigue fracture
Why 2: High stress concentration at keyway
Why 3: Sharp corner radius
Why 4: Drawing did not specify radius
Why 5: Design review did not catch omission
Root Cause: Inadequate design review process
```
#### Fishbone Diagram Categories
- Material: Composition, defects, properties
- Machine: Equipment condition, maintenance
- Method: Process, procedure, design
- Man: Training, error, supervision
- Environment: Temperature, humidity, contamination
- Measurement: Calibration, accuracy
## Process Integration
- ME-016: Failure Analysis Investigation
## Input Schema
```json
{
"failed_component": {
"part_number": "string",
"material": "string",
"service_history": "string",
"failure_date": "date"
},
"operating_conditions": {
"loads": "string",
"environment": "string",
"temperature": "number (C)",
"cycles_or_hours": "number"
},
"available_evidence": {
"fracture_surfaces": "boolean",
"mating_parts": "boolean",
"lubricant_samples": "boolean",
"maintenance_records": "boolean"
},
"analysis_scope": "preliminary|comprehensive"
}
```
## Output Schema
```json
{
"failure_mode": "fatigue|overload|corrosion|wear|other",
"root_cause": "string",
"contributing_factors": "array",
"evidence_summary": {
"visual": "string",
"fractography": "string",
"metallography": "string",
"chemical": "string"
},
"corrective_actions": [
{
"action": "string",
"category": "design|material|process|maintenance",
"priority": "high|medium|low"
}
],
"preventive_recommendations": "array",
"report_reference": "string"
}
```
## Best Practices
1. Preserve evidence before any destructive examination
2. Document all observations photographically
3. Follow systematic investigation process
4. Consider multiple failure mechanisms
5. Correlate fracture features with stress analysis
6. Validate root cause with evidence
## Integration Points
- Connects with FEA Structural for stress analysis
- Feeds into Material Selection for improved materials
- Supports Design Review for lessons learned
- Integrates with Quality for corrective actionsRelated Skills
heatmap-analysis
Analyze user interaction heatmaps for attention patterns and click behavior
static-analysis-runner
Run static analysis tools including SonarQube, ESLint, and multi-language linters
Static Analysis Tools Skill
Integration with security-focused static analysis tools
Smart Contract Analysis Skill
Ethereum and blockchain smart contract security analysis
Network Protocol Analysis Skill
Network protocol capture, analysis, and fuzzing capabilities
Code Coverage Analysis
Multi-language code coverage analysis, reporting, and quality gate enforcement
memlab-analysis
Expert skill for JavaScript memory leak detection using Facebook MemLab. Configure MemLab scenarios, execute memory leak detection runs, analyze heap snapshots, identify detached DOM elements, find event listener leaks, and integrate with CI pipelines.
gpu-memory-analysis
Specialized skill for GPU memory hierarchy analysis and optimization. Analyze memory access patterns, detect bank conflicts, optimize cache utilization, profile global memory bandwidth, and generate optimized memory access code patterns.
power-analysis
FPGA power estimation and optimization skill for low-power design
cdc-analysis
Specialized skill for clock domain crossing analysis and synchronizer design in FPGA designs
misra-c-analysis
MISRA C compliance checking and static analysis integration
memory-analysis
Embedded memory analysis, optimization, and leak detection