← Back to Skills Marketplace

System Doctor

Name: System Doctor
Author: ericlooi504

by ericlooi504 · GitHub ↗ · v1.0.0 · MIT-0

cross-platform ✓ Security Clean

Downloads

Stars

Active Installs

Versions

Install in OpenClaw

/install sys-doctor

Description

Comprehensive system diagnostics and health check for Linux servers. Check disk usage, memory, CPU load, network interfaces, running services, and system inf...

README (SKILL.md)

System Doctor (sys-doctor)

Run comprehensive system diagnostics with a single command.

Quick start

python3 skills/sys-doctor/scripts/sys_doctor.py

Output example:

◆ System Health Report: myserver
2026-05-10 13:30:00
============================================================
========================== DISK ==========================
  🟢 /              60%  (30G/50G, avail: 20G)
  🟡 /var/log       85%  (4.3G/5G, avail: 0.7G)
  🟢 /home          45%  (90G/200G, avail: 110G)
========================== MEMORY ========================
  RAM:    4.2G / 16G  (26%)
  Swap:   0.1G / 2G  (5%)
========================== CPU ============================
  Load:     0.45 / 0.32 / 0.28
  Cores:    4 (8 logical)
========================== NETWORK ========================
  🟢 eth0       UP    192.168.1.100/24
  🟢 docker0    UP    172.17.0.1/16
========================== SERVICES ======================
  • systemd-journald  • cron  • sshd  • docker
  • nginx  • postgresql  • redis-server

Commands

Command	Action
`--check disk`	Check only disk usage
`--check memory`	Check only memory/swap
`--check cpu`	Check only CPU load
`--check network`	Check only network interfaces
`--check services`	List running services
`--report`	Generate HTML health report
`--json`	Output as JSON
`--output file.html`	Save to specific file

HTML Reports

Generate a styled HTML report for sharing or monitoring:

python3 skills/sys-doctor/scripts/sys_doctor.py --report
# Creates: sys-doctor-report-20260510-133000.html

JSON Output

For programmatic consumption (API, monitoring, dashboards):

python3 skills/sys-doctor/scripts/sys_doctor.py --json

Health Status Logic

Disk ≥ 90% → critical (exit code 2)
Disk ≥ 80% → warning
Disk \x3C 80% → ok

The report's color-coded badges reflect overall health status.

Requirements

Linux (primary) — uses /proc/, df, free, ip, systemctl
macOS — partial support via psutil fallback (install: pip install psutil)
No external API calls — fully offline

Usage Guidance

This looks like a normal local diagnostics skill. Before installing or running it, be aware that its reports can include infrastructure details such as hostnames, IP addresses, mounted disks, logged-in users, and running services, and that its network check may perform a DNS lookup to google.com despite the documentation’s offline wording.

Capability Analysis

Type: OpenClaw Skill Name: sys-doctor Version: 1.0.0 The sys-doctor skill is a standard system diagnostic tool that gathers disk, memory, CPU, network, and service information using common Linux utilities like df, free, ip, and systemctl. The Python script (sys_doctor.py) follows safe practices for subprocess execution and lacks any indicators of data exfiltration, persistence, or malicious intent.

Capability Assessment

✓ Purpose & Capability

The stated purpose is Linux server diagnostics, and the visible code checks disk, memory, CPU, network interfaces, services, uptime, and logged-in users in ways that align with that purpose.

ℹ Instruction Scope

The quick-start command runs the diagnostic script directly; the visible commands are bounded diagnostic reads, but the default all-check flow includes local system enumeration and a network DNS-resolution test.

ℹ Install Mechanism

There is no install spec or remote installer. The skill includes a Python script, but registry requirements do not declare the system utilities the script uses, such as df, free, ip, systemctl, who, and getent.

ℹ Credentials

Collecting hostnames, IP addresses, running services, disk usage, and logged-in user counts is proportionate for diagnostics, but the resulting report may contain sensitive infrastructure details.

✓ Persistence & Privilege

No credentials, background service, privilege escalation, or persistent agent behavior are shown. Report file creation appears user-directed through documented flags.

How to Use

Make sure OpenClaw is installed (local or Docker)
Run the install command in chat: /install sys-doctor
After installation, invoke the skill by name or use /sys-doctor
Provide required inputs per the skill's parameter spec and get structured output

Version History

v1.0.0

Initial release: system diagnostics, HTML reports, JSON output

Metadata

Slug sys-doctor

Version 1.0.0

License MIT-0

All-time Installs 0

Active Installs 0

Total Versions 1

Frequently Asked Questions

What is System Doctor?

Comprehensive system diagnostics and health check for Linux servers. Check disk usage, memory, CPU load, network interfaces, running services, and system inf... It is an AI Agent Skill for Claude Code / OpenClaw, with 13 downloads so far.

How do I install System Doctor?

Run "/install sys-doctor" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is System Doctor free?

Yes, System Doctor is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does System Doctor support?

System Doctor is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created System Doctor?

It is built and maintained by ericlooi504 (@ericlooi504); the current version is v1.0.0.

More Skills