windows-diagnostics

Windows Diagnostics Plugin

Windows system diagnostics and troubleshooting for Claude Code. Analyzes Event Viewer, disk health, memory, hardware errors, system stability, and performance to diagnose crashes, freezes, and reboots.

Installation

/plugin install windows-diagnostics@claude-code-plugins

Prerequisites

• Windows 10/11 - This plugin is Windows-only
• PowerShell 5.1+ - For diagnostic commands (included with Windows)
• Administrator access - Some diagnostics require elevation (the agent will guide you)

Features

System Diagnostics Skill

Skill: windows-diagnostics:system-diagnostics

Comprehensive Windows troubleshooting guidance covering:

• Event Viewer analysis (Application, System, Security logs)
• Disk health assessment (SMART data, S.M.A.R.T. attributes)
• Memory diagnostics (RAM health, page file analysis)
• Hardware error detection (WHEA events, driver issues)
• System stability analysis (reliability history, uptime)
• Performance counters and resource monitoring
• BSOD/crash dump analysis

Diagnostician Agent

Agent: windows-diagnostics:diagnostician

Specialized agent for Windows system troubleshooting with:

• Read-only operations - Gathers diagnostic data without making changes
• Elevation handling - Gracefully handles admin-required commands
• Structured analysis - Provides clear findings with severity levels
• Safe recommendations - Suggests repairs for you to run manually

Diagnose Command

Command: /windows-diagnostics:diagnose

Quick access to system diagnostics workflow.

Quick Start

Troubleshoot System Issues

Describe your symptoms:

"My computer keeps randomly rebooting"
"Windows freezes after login"
"I'm getting blue screens with WHEA errors"
"Disk performance is degraded"

Run Diagnostics

/windows-diagnostics:diagnose

The diagnostician agent will:

1. Gather Event Viewer logs for errors and warnings
2. Check disk health via SMART data
3. Analyze memory status and page file configuration
4. Look for hardware errors in system logs
5. Review reliability history
6. Provide findings with recommended actions

Diagnostic Categories

Event Viewer Analysis

• Application crashes and hangs
• Service failures
• Security audit events
• System errors and warnings

Disk Health

• S.M.A.R.T. status and attributes
• Read/write error rates
• Reallocated sector counts
• Temperature warnings
• Pending/uncorrectable sectors

Memory Diagnostics

• Physical memory status
• Page file configuration
• Memory pressure indicators
• Potential memory leaks

Hardware Errors

• WHEA (Windows Hardware Error Architecture) events
• Driver-related crashes
• PCI/PCIe errors
• CPU and chipset issues

System Stability

• Reliability Monitor history
• Uptime tracking
• Recent crash events
• Update-related issues

Performance Analysis

• CPU utilization patterns
• Memory usage trends
• Disk I/O bottlenecks
• Resource contention

Safety Model

This plugin follows a read-only approach:

• Gathers data without modifying system state
• Suggests repairs for you to review and run manually
• Handles elevation gracefully - tells you when admin is needed
• No automatic fixes - you remain in control

Example Output

## Diagnostic Findings

### Critical Issues (1)
- WHEA hardware error detected: Memory controller issue
  - Event ID: 19, Time: 2024-01-15 14:32:00
  - Recommendation: Run Windows Memory Diagnostic

### Warnings (2)
- Disk SMART warning: Reallocated sector count elevated (127)
  - Drive: SAMSUNG SSD 980 PRO
  - Recommendation: Back up data, consider replacement

- High CPU usage from SearchIndexer.exe
  - Average: 45% over last hour
  - Recommendation: Rebuild search index if persistent

### Info (3)
- System uptime: 14 days, 6 hours
- Last Windows Update: 2024-01-10
- Memory: 16GB, 68% in use

Version History

• 1.0.0 - Initial release with diagnostics skill, agent, and command

License

MIT