System Performance Diagnostics
Run comprehensive performance checks to diagnose why your computer is running slow and get prioritized fixes.
Your computer has been getting slower for months and you don't know if it's a memory leak, a full disk, or too many startup programs. This playbook runs comprehensive system diagnostics — CPU, memory, disk, network, and startup analysis — and gives you a prioritized list of fixes.
Who it's for: non-technical professionals whose computers have slowed down and need clear fixes, remote workers troubleshooting performance issues without IT support, developers diagnosing why their development environment is lagging, IT support staff running quick diagnostics on user-reported performance complaints, small business owners maintaining team computers without dedicated IT help
Example
"Figure out why my laptop has been so slow lately" → Diagnostics pipeline: CPU and memory usage analysis identifying resource-hungry processes, disk space audit finding large files and unnecessary caches, startup program review with disable recommendations, browser extension and tab memory impact assessment, and prioritized fix list ordered by expected performance improvement
New here? 3-minute setup guide → | Already set up? Copy the template below.
# 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"