server-health-agent
by sanjay-gthb
DevOps & CloudBrief
Monitor VPS and server health metrics including real-time CPU usage, RAM utilization, disk usage, and Docker.
Description
What This Skill Does
Runs read-only system commands to collect CPU usage, RAM utilization, disk capacity, and Docker container status from a VPS or server. Returns structured JSON for use in monitoring workflows or further automation. Gracefully handles environments where Docker access is restricted.
Returns structured JSON directly usable in automation pipelines, avoiding the need to parse unstructured shell output manually.
When to Use It
- Checking server load before a production deploy
- Diagnosing a slow server during an incident
- Auditing running Docker containers on a remote VPS
- Alerting when disk usage approaches capacity limits
- Running scheduled infrastructure health checks in a CI pipeline
Example Workflow
User asks: What is the current health of my server?
- 1
Runs top to capture live CPU utilization
- 2
Reads RAM usage via system-level memory commands
- 3
Checks root filesystem disk usage with df
- 4
Queries the Docker socket for running container status
- 5
Assembles all metrics into a structured JSON response
{"cpu_percent":"12.44","ram_percent":"21.33","disk_usage":"51%","docker_status":"openclaw-openclaw-gateway-1: Up 2 hours"}
Installation
clawhub install sanjay-gthb/server-health-agentRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.