System Vigil

A health monitor for the host machine. It checks vital signs and returns a structured report, allowing agents to detect resource exhaustion before it causes a crash.

Capabilities

• Check Health: Get a JSON report of Disk, Memory, and CPU usage.
• Predictive Status: Returns specific flags (warning, critical) based on thresholds.

Usage

User: "Run a system health check."

Agent: python3 skills/system-vigil/check.py

Output:

{
  "status": "ok",
  "disk": { "used_percent": 45, "free_gb": 120 },
  "memory": { "used_percent": 30, "free_gb": 12 },
  "cpu": { "load_15m": 0.5 }
}

Implementation

A Python script parsing standard Linux utils (df, free, uptime).