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

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

CLAUDE.md Template

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

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

Productivity

Validate Output

Validate content structure.

15 minutes
Intermediate
Productivity

Verify Claims

Verify marketing claims.

15 minutes
Intermediate
Productivity

Weather-Based Automation

Automate weather-based workflows, forecasts, alerts, and location-aware notifications

10 minutes
Intermediate
Productivity

Voice & Screenshot Workflow

Control Claude Code with voice dictation and automatic screenshot review - almost no typing required.

15 minutes
Intermediate
Productivity

Video Downloader

Download YouTube videos with customizable quality and format settings, including audio extraction to MP3.

5 minutes
Beginner
Productivity

Year-in-Review Generator

Automatically compile your yearly accomplishments from Jira tickets, git history, emails, and documents into a polished summary for performance reviews or personal reflection.

5 minutes
Beginner
Productivity

Travel Planner

Create personalized travel itineraries with day-by-day plans, budget breakdowns, packing lists, and cultural tips based on your preferences.

10 minutes
Beginner
Productivity

Travel Command Center

Centralize your entire trip in one workspace — itinerary, bookings, packing list, and restaurant picks that all reference each other.

5 minutes
Beginner
Productivity

Raffle Winner Picker

Randomly select winners from Google Sheets, CSVs, or lists for giveaways with transparent, verifiable selection.

5 minutes
Beginner
Productivity

Add Integration

Add MCP server integrations.

15 minutes
Intermediate
Productivity

Activity Digest Generator

Generate daily or weekly activity digests across all connected platforms

10 minutes
Beginner
Productivity

Calendar & Scheduling Automation

Google Calendar and Outlook automation - scheduling optimization, meeting workflows, time blocking, and Slack/Sheets integration

10 minutes
Intermediate

Browse all Productivity playbooks →