system-diagnostics

# Windows System Diagnostics

Comprehensive Windows 11 system diagnostics using PowerShell. This skill helps diagnose crashes, freezes, unexpected reboots, disk problems, memory issues, hardware errors, and performance bottlenecks.

## Table of Contents

- [Quick Start](#quick-start) - Immediate diagnostic commands
- [Platform Requirements](#platform-requirements) - Windows 11, PowerShell 7+
- [Diagnostic Categories](#diagnostic-categories) - What this skill covers
- [Quick Health Check](#quick-health-check) - Fast system overview
- [Reference Loading](#reference-loading-guide) - Progressive disclosure
- [Safety Model](#safety-model) - Read-only vs suggested repairs
- [Common Issues](#common-diagnostic-scenarios) - Troubleshooting patterns

## Overview

This skill provides read-only diagnostic capabilities to gather system health information. It does NOT execute repair commands - those are provided as suggestions for the user to run manually.

**Capabilities:**

- Event log analysis (crashes, errors, warnings)
- Disk health monitoring (SMART data, filesystem errors)
- Memory diagnostics (usage, leaks, hardware issues)
- Hardware error detection (device failures, drivers, WHEA)
- Performance analysis (CPU, memory, disk bottlenecks)
- System stability metrics (uptime, restart reasons)

## When to Use This Skill

Use this skill when:

- Computer is crashing, freezing, or rebooting unexpectedly
- Blue Screen of Death (BSOD) errors occur
- Disk health concerns (slow performance, errors)
- Memory issues suspected (high usage, crashes under load)
- Hardware errors or driver problems
- Need to analyze Windows Event Viewer logs
- System performance degradation
- Investigating application crashes

## Platform Requirements

**Required:**

- Windows 11 (this skill is optimized for Windows 11 Pro)
- PowerShell 7+ (`pwsh`) for best compatibility

**Verify PowerShell version:**

```powershell
$PSVersionTable.PSVersion
```

**Note:** Most commands also work with Windows PowerShell