failure-analysis

Systematic failure analysis methodology for mechanical component failures

509 stars

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

$curl -o ~/.claude/skills/failure-analysis/SKILL.md --create-dirs "https://raw.githubusercontent.com/a5c-ai/babysitter/main/library/specializations/domains/science/mechanical-engineering/skills/failure-analysis/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/failure-analysis/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How failure-analysis Compares

Feature / Agentfailure-analysisStandard Approach
Platform SupportNot specifiedLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/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 actions

Related Skills

heatmap-analysis

509
from a5c-ai/babysitter

Analyze user interaction heatmaps for attention patterns and click behavior

static-analysis-runner

509
from a5c-ai/babysitter

Run static analysis tools including SonarQube, ESLint, and multi-language linters

Static Analysis Tools Skill

509
from a5c-ai/babysitter

Integration with security-focused static analysis tools

Smart Contract Analysis Skill

509
from a5c-ai/babysitter

Ethereum and blockchain smart contract security analysis

Network Protocol Analysis Skill

509
from a5c-ai/babysitter

Network protocol capture, analysis, and fuzzing capabilities

Code Coverage Analysis

509
from a5c-ai/babysitter

Multi-language code coverage analysis, reporting, and quality gate enforcement

memlab-analysis

509
from a5c-ai/babysitter

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

509
from a5c-ai/babysitter

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

509
from a5c-ai/babysitter

FPGA power estimation and optimization skill for low-power design

cdc-analysis

509
from a5c-ai/babysitter

Specialized skill for clock domain crossing analysis and synchronizer design in FPGA designs

misra-c-analysis

509
from a5c-ai/babysitter

MISRA C compliance checking and static analysis integration

memory-analysis

509
from a5c-ai/babysitter

Embedded memory analysis, optimization, and leak detection