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/...andassets/... - 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
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.jsonData 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.jsonReport Generation: Read both
sys_info.jsonandanalysis_result.json. Present the findings to the user using the template found inassets/report_template.md.
Reference Materials
- Symptoms Guide: See
references/symptoms.mdto 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.