diagnose

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