← Back to Skills Marketplace
Disk Usage Watcher
by
nidalghETF
· GitHub ↗
· v1.0.1
472
Downloads
0
Stars
1
Active Installs
2
Versions
Install in OpenClaw
/install disk-usage-watcher
Description
Monitors disk space and inode usage on specified paths, alerting when set thresholds are exceeded to prevent disk-full issues.
README (SKILL.md)
Disk Usage Watcher
Description
Monitors disk space and inode usage on specified paths, sending alerts when thresholds are exceeded. Essential for preventing disk-full incidents.
Usage
The agent can call this skill directly or it runs automatically via cron every 15 minutes.
Example Prompts:
- "Check disk space on root partition"
- "Monitor all mount points and alert at 85%"
- "Show me disk usage statistics"
Inputs
threshold_percent: number — Alert when usage exceeds this percentage (default: 85)inode_threshold: number — Alert when inode usage exceeds this percentage (default: 85)paths: array — Specific paths to monitor (default: all mounted partitions)alert_on_failure: boolean — Send alert if check fails (default: true)
Outputs
status: string — "success" or "failure"details: object — Contains disk_usage array with mount points, usage percentages, and any triggered alerts
Dependencies
openclaw/exec- For running df commandsopenclaw/notify- For sending alerts
Testing
openclaw call disk-usage-watcher --params '{"paths": ["/"]}'
Usage Guidance
This skill appears to be what it claims: a small instruction-only disk/inode monitor that uses the platform's exec and notify helpers. Before installing, confirm how notifications are delivered (openclaw/notify) so alerts don't go to unintended channels. Also note the SKILL.md mentions automatic cron runs but there is no install step to create a cron job — if you want periodic checks you must configure scheduling yourself or verify your agent platform will schedule it. Finally, because the skill invokes df-style commands, it will observe the host's mount and usage state (normal for monitoring), so only install on agents where you are comfortable letting the agent inspect disk state.
Capability Analysis
Type: OpenClaw Skill
Name: disk-usage-watcher
Version: 1.0.1
The skill bundle describes a standard disk usage monitoring tool. The `SKILL.md` documentation is straightforward, outlining the skill's purpose, usage, inputs, and dependencies. There are no prompt injection attempts, instructions for malicious actions, or indications of data exfiltration or unauthorized persistence within the provided files. The use of `openclaw/exec` is consistent with the stated need to run `df` commands for disk monitoring.
Capability Assessment
Purpose & Capability
Name/description (monitor disk space/inodes) align with the instructions and declared dependencies (openclaw/exec to run df-like checks and openclaw/notify to send alerts). No unrelated binaries or credentials are requested.
Instruction Scope
SKILL.md stays focused on checking disk/inode usage and alerting. It references running df-style commands via openclaw/exec and sending notifications via openclaw/notify. Minor note: it states 'runs automatically via cron every 15 minutes' but provides no install steps to create a cron job — scheduling is implied but not implemented by the instruction-only package.
Install Mechanism
Instruction-only (no install spec, no downloads, no code files). This has a low install risk surface because nothing is written to disk by the skill itself.
Credentials
No environment variables, credentials, or config paths are required. The absence of secrets is appropriate for a local disk monitoring task that uses the platform exec/notify primitives.
Persistence & Privilege
always:false and no requested persistent config make this non-invasive. However, the doc's claim of automatic cron execution implies persistent scheduling that is not implemented here — install/scheduling would need to be configured elsewhere.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install disk-usage-watcher - After installation, invoke the skill by name or use
/disk-usage-watcher - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
- Added _meta.json file to the repository.
- No functional changes to the skill itself.
v1.0.0
Initial release of disk-usage-watcher.
- Monitors disk space and inode usage on specified paths.
- Sends alerts when usage exceeds configurable percentage thresholds.
- Supports automatic checks every 15 minutes via cron or manual invocation.
- Flexible input options for thresholds, paths, and alert settings.
- Provides usage status and details for each monitored mount point.
Metadata
Frequently Asked Questions
What is Disk Usage Watcher?
Monitors disk space and inode usage on specified paths, alerting when set thresholds are exceeded to prevent disk-full issues. It is an AI Agent Skill for Claude Code / OpenClaw, with 472 downloads so far.
How do I install Disk Usage Watcher?
Run "/install disk-usage-watcher" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Disk Usage Watcher free?
Yes, Disk Usage Watcher is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Disk Usage Watcher support?
Disk Usage Watcher is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Disk Usage Watcher?
It is built and maintained by nidalghETF (@nidalghetf); the current version is v1.0.1.
More Skills