Windows Diagnostics Command
Run comprehensive Windows 11 system diagnostics using PowerShell to identify causes of crashes, freezes, unexpected reboots, and performance issues.
Instructions
Use the diagnostician agent to analyze system health based on the specified scope.
The diagnostician agent uses the windows-diagnostics:system-diagnostics skill for:
- Event log analysis (crashes, errors, warnings)
- Disk health monitoring (SMART data, filesystem)
- Memory diagnostics (usage, leaks, hardware)
- Hardware error detection (WHEA, devices, drivers)
- Performance analysis (CPU, memory, disk bottlenecks)
- System stability metrics (uptime, restarts, BSOD)
Parse the arguments and invoke the agent:
$ARGUMENTS
Based on the arguments, determine the diagnostic scope:
If 'quick' or no arguments:
- Run quick health check (system info, uptime, recent errors, disk/memory snapshot)
- Good for initial triage
If 'events':
- Focus on Windows Event Viewer analysis
- Look for critical and error events
- Check System and Application logs
If 'disk':
- Focus on disk health diagnostics
- Check SMART data, reliability counters
- Look for disk-related events
If 'memory':
- Focus on memory diagnostics
- Analyze memory usage, top consumers
- Check for memory-related events
If 'stability':
- Focus on system stability
- Check uptime, restart patterns
- Look for unexpected shutdowns
If 'hardware':
- Focus on hardware error detection
- Check device status, WHEA events
- Look for driver issues
If 'performance':
- Focus on performance analysis
- Check CPU, memory, disk utilization
- Identify bottlenecks
If 'crashes':
- Focus on crash analysis
- Check for BSOD events, minidumps
- Look for application crashes
If 'full':
- Run comprehensive diagnostic across all categories
- Takes longer but provides complete picture
Default: quick health check
Examples
Quick Health Check
/windows-diagnostics:diagnose
/windows-diagnostics:diagnose quick
Event Log Analysis
/windows-diagnostics:diagnose events
Disk Health Check
/windows-diagnostics:diagnose disk
Memory Diagnostics
/windows-diagnostics:diagnose memory
System Stability Analysis
/windows-diagnostics:diagnose stability
Hardware Error Detection
/windows-diagnostics:diagnose hardware
Performance Analysis
/windows-diagnostics:diagnose performance
Crash Analysis
/windows-diagnostics:diagnose crashes
Full Comprehensive Scan
/windows-diagnostics:diagnose full
Output Format
The agent returns a structured diagnostic report:
## Diagnostic Summary
**Scope**: [Category analyzed]
**System**: [Windows version, uptime]
**Timestamp**: [When diagnostic was run]
## Findings
### Critical Issues
[Issues requiring immediate attention]
### Warnings
[Potential problems to monitor]
### Observations
[General health observations]
## Recommendations
### Suggested Actions (User Runs)
[Commands/steps for user to execute manually]
### Further Investigation
[Areas that may need deeper analysis]
## Raw Data
[Key diagnostic output for reference]
Safety Model
This command uses read-only diagnostics:
- Only gathers system information
- Never executes repair commands automatically
- Provides repair suggestions for user to run manually
- Notes when administrator privileges would be needed
Command Design Notes
This command delegates to the diagnostician agent, which uses the windows-diagnostics:system-diagnostics skill. The skill provides:
- PowerShell commands for each diagnostic category
- Progressive disclosure of reference files based on scope
- Safety guidelines for read-only vs write operations
- Graceful degradation when not running as administrator