Home
cd ../playbooks
ProductivityBeginner

System Performance Diagnostics

Run comprehensive performance checks to diagnose why your computer is running slow and get prioritized fixes.

5 minutes
By communitySource
#performance#diagnostics#system#optimization#troubleshooting
CLAUDE.md Template

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?"
```

README.md

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"

$Related Playbooks