← Back to Skills Marketplace
114
Downloads
0
Stars
1
Active Installs
1
Versions
Install in OpenClaw
/install disk-usage
Description
Show disk usage of a directory or file in human-readable format. Use when the user wants to know how much space a folder or file takes.
README (SKILL.md)
Disk Usage
Show how much disk space a directory or file uses with a single command.
Usage
du -sh \x3CPATH>
Arguments:
| # | Name | Description |
|---|---|---|
| 1 | PATH | Path to file or directory to measure |
Example
du -sh /home/user/projects
Output:
1.2G /home/user/projects
Format: SIZE PATH
Success / Failure
- Success: One line with human-readable size and path (exit code 0)
- Failure: Error message (exit code non-zero, e.g. path not found)
Usage Guidance
This skill appears safe to run from a security perspective: it uses only the local du command, asks for no credentials, and contains no network calls. However, there is a functional inconsistency: the description and SKILL.md say it works for files or directories, but the included run.sh explicitly rejects non-directory arguments and lists only non-hidden entries (DIR/*), so hidden files/directories won’t be shown. Before installing or running, inspect run.sh (you already have it) and confirm it matches what you need. If you need file support or inclusion of hidden files, modify the script (e.g., allow files, and use du -sh "$DIR_PATH" or adjust globbing). Only run code from sources you trust; although no malicious behavior is evident, verifying the script is good practice.
Capability Analysis
Type: OpenClaw Skill
Name: disk-usage
Version: 1.0.0
The disk-usage skill is a straightforward utility for measuring directory and file sizes using the standard 'du' command. The implementation in run.sh and the instructions in SKILL.md are well-structured, include basic error handling, and align perfectly with the stated purpose without any signs of malicious intent or suspicious behavior.
Capability Assessment
Purpose & Capability
The skill's stated purpose is to show disk usage for a file or directory. The SKILL.md example (du -sh <PATH>) would support files or directories, but the provided run.sh explicitly rejects non-directory arguments (it checks [ ! -d "$DIR_PATH" ] and errors). That mismatch between description and the runnable script is an inconsistency a user should be aware of.
Instruction Scope
Both SKILL.md and run.sh limit actions to running du on local filesystem paths, sorting results, and printing the total. There are no network calls, no reading of unrelated files or environment variables, and no exfiltration. Note: run.sh uses the shell glob DIR/* so it will omit hidden (dot) entries and may behave differently on empty directories (shell glob expansion), which is a functional caveat rather than a security issue.
Install Mechanism
No install spec — instruction-only plus a small helper script. Nothing is downloaded or written to disk by an installer; risk from installation is minimal.
Credentials
The skill declares no required environment variables or credentials and the code does not reference any environment secrets. Required binary du is appropriate for the stated purpose.
Persistence & Privilege
The skill does not request permanent or elevated presence (always=false). It does not modify other skills or system configs and does not request privileged access.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install disk-usage - After installation, invoke the skill by name or use
/disk-usage - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release of disk-usage skill.
- Provides disk usage in a human-readable format for any file or directory.
- Uses the Bash du -sh <PATH> command to measure space.
- Outputs size and path in a single line, or an error message if the path is invalid.
Metadata
Frequently Asked Questions
What is Disk Usage?
Show disk usage of a directory or file in human-readable format. Use when the user wants to know how much space a folder or file takes. It is an AI Agent Skill for Claude Code / OpenClaw, with 114 downloads so far.
How do I install Disk Usage?
Run "/install disk-usage" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Disk Usage free?
Yes, Disk Usage is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Disk Usage support?
Disk Usage is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Disk Usage?
It is built and maintained by 목진왕 (@jinwangmok); the current version is v1.0.0.
More Skills