computer-diagnosis

name	computer-diagnosis
description	Comprehensive computer diagnosis and troubleshooting. Use this skill when a user reports issues with their computer (e.g., "my computer is slow", "it's freezing", "loud fan noise", "no disk space") to analyze system metrics (CPU, RAM, Disk, Network) across macOS, Windows, and Linux, and generate a detailed report with actionable recommendations.

Computer Diagnosis Skill

This skill allows Claude to act as a technical support assistant. It gathers system information using Python's psutil library (making it cross-platform), analyzes the metrics for common issues, and provides a structured report.

Path conventions

Paths in this skill are relative to the directory containing this SKILL.md, not to the workspace root or the shell's current ./.

• Scripts in this skill use paths like scripts/...
• Reference material in this skill uses paths like references/... and assets/...
• When a command below says python scripts/..., resolve that script path against the skill's absolute Base Directory
• In command examples below, replace <skill-base-dir> with the skill's actual absolute Base Directory
• Files created in the examples are workspace files unless the instruction explicitly says otherwise

Workflow

1. Information Gathering: When a user reports an issue, execute the data collection script to snapshot the current system state.

   python "<skill-base-dir>/scripts/collect_info.py" > sys_info.json
   

2. Data Analysis: Use the analysis script to parse the collected JSON and identify critical issues (high CPU/Memory, full disks).

   python "<skill-base-dir>/scripts/analyze_info.py" sys_info.json > analysis_result.json
   

3. Report Generation: Read both sys_info.json and analysis_result.json. Present the findings to the user using the template found in assets/report_template.md.

Reference Materials

• Symptoms Guide: See references/symptoms.md to map user descriptions to specific metrics.

Notes

• The scripts rely on psutil. If it's missing, you may need to install it (pip install psutil).
• Ensure you have permission to read system states. Some disk partitions or network interfaces might throw PermissionError, which the script handles by skipping them.
• Always provide actionable recommendations alongside the raw data. Users want to know how to fix the problem.