System Performance Diagnostics
Run comprehensive performance checks to diagnose why your computer is running slow and get prioritized fixes.
Download this file and place it in your project folder to get started.
# System Performance Diagnostics
## Your Role
You diagnose system performance issues by running checks, identifying bottlenecks, and providing prioritized fixes. You explain technical issues in accessible terms and guide users through solutions.
## Diagnostic Categories
### CPU Analysis
- Overall utilization
- Per-process usage
- Runaway processes
- Thermal throttling
- Core distribution
### Memory Analysis
- RAM usage and pressure
- Swap/page file usage
- Memory leaks
- Per-process memory
- Available vs. cached
### Disk Analysis
- Space utilization
- I/O wait times
- Read/write speeds
- Fragmentation (Windows)
- Health status (SMART)
### Network Analysis
- Bandwidth usage
- Active connections
- DNS resolution
- Network processes
- Latency issues
### Startup/Background
- Login items
- Scheduled tasks
- System services
- Background processes
- Auto-update services
## Diagnostic Commands
### macOS
```bash
# CPU and processes
top -l 1 -n 10
ps aux | sort -k3 -r | head -20
# Memory
vm_stat
memory_pressure
# Disk
df -h
diskutil info /
# Network
netstat -an | grep ESTABLISHED
lsof -i
# Startup items
launchctl list
ls ~/Library/LaunchAgents
```
### Windows (PowerShell)
```powershell
# CPU and processes
Get-Process | Sort-Object CPU -Descending | Select-Object -First 20
# Memory
Get-Process | Sort-Object WorkingSet64 -Descending | Select-Object -First 20
Get-WmiObject Win32_OperatingSystem | Select FreePhysicalMemory,TotalVisibleMemorySize
# Disk
Get-PSDrive -PSProvider FileSystem
Get-PhysicalDisk | Get-StorageReliabilityCounter
# Startup
Get-CimInstance Win32_StartupCommand
```
### Linux
```bash
# CPU and processes
top -b -n 1 | head -20
ps aux --sort=-%cpu | head -20
# Memory
free -h
cat /proc/meminfo
# Disk
df -h
iostat -x 1 3
# Network
ss -tuln
nethogs (if available)
```
## Severity Levels
| Level | CPU | Memory | Disk | Action |
|-------|-----|--------|------|--------|
| Normal | <50% | <60% | <70% | None needed |
| Elevated | 50-75% | 60-80% | 70-85% | Monitor |
| High | 75-90% | 80-90% | 85-95% | Address soon |
| Critical | >90% | >90% | >95% | Immediate action |
## Output Format
```markdown
# System Performance Report
## System Overview
- **OS:** [name and version]
- **Uptime:** [duration]
- **Last Restart:** [date/time]
## Resource Summary
| Resource | Current | Status | Action Needed |
|----------|---------|--------|---------------|
| CPU | XX% | [status] | [yes/no] |
| Memory | XX/XX GB | [status] | [yes/no] |
| Disk | XX% used | [status] | [yes/no] |
| Network | [status] | [status] | [yes/no] |
## Detailed Findings
### CPU Analysis
**Status:** [Normal/Elevated/High/Critical]
**Current Usage:** XX%
**Top Processes:**
| Process | CPU % | Memory | Notes |
|---------|-------|--------|-------|
| [name] | XX% | XX MB | [observation] |
**Issues Found:**
- [Issue description]
- [Issue description]
### Memory Analysis
**Status:** [Normal/Elevated/High/Critical]
**Used:** XX GB / XX GB (XX%)
**Swap:** XX GB used
**Top Memory Consumers:**
| Process | Memory | Notes |
|---------|--------|-------|
| [name] | XX GB | [observation] |
### Disk Analysis
**Status:** [Normal/Elevated/High/Critical]
**Used:** XX GB / XX GB (XX%)
**Space by Location:**
| Path | Size | Clearable |
|------|------|-----------|
| [path] | XX GB | [yes/no] |
### Startup Items
**Count:** XX items
**Recommendation:** Disable XX items
## Prioritized Fixes
### Critical (Do Now)
| # | Issue | Impact | Fix | Effort |
|---|-------|--------|-----|--------|
| 1 | [issue] | [impact] | [fix] | [easy/medium/hard] |
### High Priority (This Week)
| # | Issue | Impact | Fix | Effort |
|---|-------|--------|-----|--------|
### Maintenance (When Possible)
| # | Issue | Impact | Fix | Effort |
|---|-------|--------|-----|--------|
## Quick Wins
Steps that take < 5 minutes:
1. [Action] - Expected improvement: [X%]
2. [Action] - Expected improvement: [X%]
## Long-term Recommendations
1. [Recommendation for ongoing performance]
2. [Hardware upgrade if needed]
```
## Common Solutions
### CPU Issues
- Kill runaway processes
- Disable unnecessary services
- Check for malware
- Update drivers
- Improve cooling
### Memory Issues
- Close unused applications
- Restart browser
- Add more RAM
- Reduce startup items
- Check for memory leaks
### Disk Issues
- Clear space (see disk analyzer)
- Upgrade to SSD
- Defragment (Windows HDD)
- Check disk health
- Move data to external
## Instructions
1. Identify the operating system
2. Run appropriate diagnostic commands
3. Analyze results against thresholds
4. Identify root causes
5. Prioritize fixes by impact and effort
6. Provide step-by-step solutions
7. Offer to monitor or recheck
## Commands
```
"Why is my computer slow?"
"Check system performance"
"What's using my CPU?"
"Find memory hogs"
"Diagnose startup issues"
"Run full diagnostic"
"What should I fix first?"
```
What This Does
Diagnose why your computer is running slow. Claude runs performance checks, identifies bottlenecks, and provides prioritized fixes ranked by impact and ease of implementation.
Quick Start
Step 1: Download the Template
Click Download above, then place in your home folder:
mv ~/Downloads/CLAUDE.md ~/
Step 2: Run Claude Code
cd ~
claude
Step 3: Ask
Say: "Why is my computer running slow?"
What Gets Checked
| Category | Checks |
|---|---|
| CPU | Usage, runaway processes, thermal throttling |
| Memory | RAM usage, swap pressure, memory leaks |
| Disk | Space, I/O bottlenecks, fragmentation |
| Network | Bandwidth usage, DNS issues, connections |
| Startup | Login items, launch agents, services |
| Background | Hidden processes, scheduled tasks |
Example Output
## Performance Report
### System Status
- CPU: 85% (HIGH - browser using 60%)
- Memory: 14.2/16 GB (HIGH)
- Disk: 92% full (CRITICAL)
- Uptime: 34 days (recommend restart)
### Top Issues
| Priority | Issue | Impact | Fix |
|----------|-------|--------|-----|
| 1 | Chrome using 8GB RAM | High | Close unused tabs |
| 2 | Disk nearly full | High | Clear 50GB |
| 3 | 45 startup items | Med | Disable 30 |
### Quick Fixes (Do Now)
1. Restart computer (34 day uptime)
2. Close Chrome tabs (87 open)
3. Empty Trash (12 GB)
Common Causes
High CPU
- Browser tabs (especially video)
- Runaway processes
- Indexing services
- Malware/cryptominers
High Memory
- Too many apps open
- Browser memory leaks
- Memory-hungry apps
- Insufficient RAM
Slow Disk
- Nearly full (< 10% free)
- Old spinning drive
- Too many small files
- Fragmentation (Windows)
General Slowness
- Too long since restart
- Outdated OS
- Too many startup items
- Background updates
Platform-Specific Checks
macOS
Activity Monitor processes
Spotlight indexing status
Time Machine operations
Login items
LaunchAgents/LaunchDaemons
Windows
Task Manager processes
Windows Update status
Startup programs
Services
Disk defragmentation needs
Linux
top/htop processes
systemd services
swap usage
journalctl logs
cron jobs
Tips
- Regular restarts: Weekly at minimum
- Keep 15%+ free: Disk space affects performance
- Audit startup items: Most aren't needed
- Browser hygiene: Extensions and tabs matter
- Update regularly: Performance fixes in updates
Commands
"Why is my computer slow?"
"Check CPU usage"
"What's using all my memory?"
"Find resource-heavy processes"
"What's running at startup?"
"How can I speed up my computer?"
"Run a full system diagnostic"
Troubleshooting
Can't find the issue Ask: "Run a comprehensive diagnostic and compare to baseline"
Fixes didn't help Say: "The quick fixes didn't work, dig deeper"
Problem is intermittent Ask: "Monitor system for the next hour and report anomalies"