PC Assistant - Healthcheck Skill

Overview

This skill runs a comprehensive PC healthcheck that provides detailed system information along with actionable recommendations to fix any issues found. Supports Windows, macOS, and Linux.

When to Use

• - User asks for a "PC healthcheck", "system check", or "diagnostics"
• User wants to check storage, CPU, memory, GPU, or network
• User asks "how is my PC doing?" or "is everything ok?"
• User needs specific recommendations to fix issues (like low disk space)

Requirements

• - Platform: Windows, macOS, or Linux (including WSL)
• Permissions: Read-only for most checks
• Tools used: Platform-specific system utilities

Execute Healthcheck

The skill automatically detects your OS and runs the appropriate script:

CODEBLOCK0

Or use the convenience wrapper (auto-detects OS):

CODEBLOCK1

The script outputs:

• - healthcheck_YYYYMMDD_HHMMSS.txt - Full human-readable report with recommendations
• INLINECODE1 - JSON summary

Platform-Specific Features

Linux/WSL

• - System overview (OS, kernel, uptime)
• Storage & disk (df, partitions, SMART)
• Network (interfaces, routes, DNS, ports)
• Processes & services (systemctl)
• Users & security (SSH keys, failed logins)
• Package management (apt, npm, pip)
• Containers (Docker, Podman)
• GPU info (nvidia-smi)
• Hardware (USB, PCI, temperature)

Windows (PowerShell)

• - System overview (Win32OperatingSystem)
• CPU & memory (Win32Processor, Win32OperatingSystem)
• Storage (Win32LogicalDisk)
• Network adapters
• Processes (Get-Process)
• Services (Get-Service)
• Installed software (registry)
• Security (Firewall, Windows Defender)
• Event logs

macOS

• - System overview (swvers, systemprofiler)
• CPU & memory (vm_stat, sysctl)
• Storage (diskutil)
• Network (ifconfig, airport)
• Processes (ps)
• Launch agents & daemons
• Security (Firewall, Gatekeeper, FileVault)
• Homebrew packages
• Battery status

What the Healthcheck Captures

Recommendations Included

The report automatically includes specific recommendations when issues are detected:

Storage Issues (High disk usage)

• - Specific folders to check
• Platform-specific cleanup instructions
• Docker/container cleanup commands

Memory Issues

• - How to free up RAM
• Which apps to close

General Maintenance

• - System update commands
• Security best practices

Scheduling (Cron Jobs)

The skill includes a scheduler script for automated periodic healthchecks:

Quick Start

CODEBLOCK2

Configuration Options

Create a config file at ~/.config/pc-assistant.conf:

CODEBLOCK3

Environment Variables

Cron Job Example

CODEBLOCK4

Output

Reports are saved to:

• - Linux/WSL: /tmp/pc-healthcheck/ (or custom via config)
• Windows: $env:TEMP\pc-healthcheck\ (usually C:\Users\...\AppData\Local\Temp\pc-healthcheck\)
• macOS: INLINECODE16

When using scheduler: HealthCheck_YYYYMMDD_HHMMSS.txt and INLINECODE18

Tips

• - The script is read-only and safe to run multiple times
• Reports are timestamped for historical tracking
• Use JSON output for integration with monitoring
• Set PC_ASSISTANT_CLEANUP=true to auto-remove old reports