← Back to Skills Marketplace
System Vigil
by
splicer scorn
· GitHub ↗
· v1.0.0
421
Downloads
0
Stars
2
Active Installs
1
Versions
Install in OpenClaw
/install system-vigil
Description
Monitor host system health (Disk, RAM, CPU). Returns structured JSON status for predictive maintenance.
README (SKILL.md)
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).
Usage Guidance
This skill appears to do what it says: run the Python script to get a JSON health snapshot from df/free and /proc/loadavg. Before installing, consider: (1) the author/source is unknown—review the code yourself or run it in a sandbox/container; (2) the script uses static thresholds (not true predictive analytics), so adjust thresholds if needed; (3) the SKILL.md mentions uptime but the script doesn't call it—ensure your runtime has df and free available and that you run this on a Linux host; (4) if you need long-running monitoring or remote reporting, the skill currently does not send data anywhere (no network calls), so add a review step before extending it to transmit metrics.
Capability Analysis
Type: OpenClaw Skill
Name: system-vigil
Version: 1.0.0
The skill bundle is designed to monitor host system health using standard Linux utilities (`df`, `free`, `uptime`) and `/proc/loadavg`. The `check.py` script executes these commands with hardcoded arguments, mitigating shell injection risks. There is no evidence of data exfiltration, unauthorized network activity, persistence mechanisms, or prompt injection attempts against the agent in SKILL.md. All actions align with the stated purpose of system health monitoring.
Capability Assessment
Purpose & Capability
Name/description match the behavior: the script reports disk, memory, and 15m load. Minor mismatch: SKILL.md/registry declare 'uptime' as a required binary but the code reads /proc/loadavg and never invokes uptime. The README's claim of 'Predictive Status' is optimistic — the script uses static threshold checks rather than prediction models.
Instruction Scope
SKILL.md instructs the agent to run the included Python script and shows the JSON output format. The instructions do not ask the agent to read unrelated files, access credentials, or send data externally; the script only calls df and free and reads /proc/loadavg and prints JSON to stdout.
Install Mechanism
No install spec is provided (instruction-only invocation with bundled code). There is no external download or package installation; package.json only provides a convenience script entry pointing to check.py.
Credentials
The skill requests no environment variables or credentials. The only resources accessed are standard local system utilities (/proc/loadavg, df, free). This is proportional to a local system-health checker.
Persistence & Privilege
The skill does not request persistent/always-on privileges, does not modify system or other skills' configs, and is user-invocable only. Autonomous invocation is allowed by platform default but is not itself unusual here.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install system-vigil - After installation, invoke the skill by name or use
/system-vigil - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of system-vigil.
- Monitors host system health for Disk, RAM, and CPU usage.
- Returns structured JSON status for easy integration and predictive maintenance.
- Flags resource exhaustion with `warning` and `critical` statuses based on thresholds.
- Uses standard Linux commands: `df`, `free`, and `uptime`.
Metadata
Frequently Asked Questions
What is System Vigil?
Monitor host system health (Disk, RAM, CPU). Returns structured JSON status for predictive maintenance. It is an AI Agent Skill for Claude Code / OpenClaw, with 421 downloads so far.
How do I install System Vigil?
Run "/install system-vigil" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is System Vigil free?
Yes, System Vigil is completely free (open-source). You can download, install and use it at no cost.
Which platforms does System Vigil support?
System Vigil is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created System Vigil?
It is built and maintained by splicer scorn (@numbpill3d); the current version is v1.0.0.
More Skills