diskclean
v1.0.0AI-assisted disk space scanner and cleaner. Finds reclaimable space (node_modules, build caches, package caches, downloads, Docker, Xcode, logs) and intellig...
⭐ 0· 80·0 current·0 all-time
byJack Reid@0xj7r
MIT-0
Download zip
LicenseMIT-0 · Free to use, modify, and redistribute. No attribution required.
Security Scan
OpenClaw
Benign
medium confidencePurpose & Capability
Name and description match the provided assets: a bash script that scans $HOME for reclaimable items and uses a single python3 invocation to aggregate results. Declared requirement (python3) is reasonable for the python3-based aggregation step. Optional use of docker/go/homebrew is consistent with scanning those ecosystems.
Instruction Scope
SKILL.md stays within the disk-cleaning scope and includes explicit guardrails (never delete outside $HOME, dry-run required, don't delete .git, log deletions). However the instructions also tell the agent it may delete suggest-tier items with rm -rf after confirming paths under $HOME — that gives the agent the ability to run destructive shell commands. The provided diskclean.sh mostly emits scan items; the file is truncated in the submission so the actual deletion implementation and path-safety checks for the 'clean --confirm' subcommand could not be fully verified.
Install Mechanism
No install spec; instruction-only approach with a single bundled shell script is low-risk from an install standpoint. The script is intended to be copied into PATH or run in-place; there is no remote download or archive extraction declared.
Credentials
No credentials or unrelated environment variables are requested. The script reads HOME and writes to ~/.openclaw/diskclean for reports/logs, which is proportionate to its purpose.
Persistence & Privilege
always:false and default autonomous invocation is used. The skill stores its own scan reports and deletion log under the user's home (~/.openclaw/diskclean), which is expected behavior and does not modify other skills or system-wide settings.
Assessment
This skill appears to do what it says, but it can perform destructive deletions. Before installing or running: 1) Inspect the rest of diskclean.sh (the provided copy is truncated) to confirm how the 'clean --confirm' path-checks and delete operations are implemented (ensure they enforce $HOME and avoid shell globbing surprises). 2) Always run scans and 'clean --dry' first and review the generated JSON in ~/.openclaw/diskclean/scans/. 3) Back up important data before first use. 4) Be cautious about following SKILL.md guidance to run manual 'rm -rf' — prefer using the script's vetted delete command only after reviewing its code. 5) If you plan to symlink the script into /usr/local/bin, verify the file contents locally and avoid installing from untrusted sources.Like a lobster shell, security has layers — review code before you run it.
latestvk97dpct1hg1v0rr5cbrnqmam5d83rt53
License
MIT-0
Free to use, modify, and redistribute. No attribution required.
Runtime requirements
🧹 Clawdis
OSmacOS · Linux
Binspython3
