# System Vigil

> Monitor host system health (Disk, RAM, CPU). Returns structured JSON status for predictive maintenance.

- Skill: `modbender/system-vigil` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add modbender/system-vigil`
- Raw SKILL.md: https://api.skillmd.com/api/skills/modbender/system-vigil/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: modbender (https://skillmd.com/u/modbender)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/modbender/system-vigil

---


# 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:**
```json
{
  "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`).