free-my-disk

85 / 100 · Low risk

Fine to try. Some of what it can do is expected: a coding skill usually runs build and test commands.

By wquguru/skills (GitHub) · coding · 94 stars · scanned at commit a432f94

Safely audit and reclaim disk space on macOS and Ubuntu/Linux hosts, including remote servers over SSH. Use when the user says their Mac, Linux box, VPS, or server disk is full, asks what can be safely deleted, wants to clean caches, developer artifacts, Docker storage, apt/Homebrew/npm/pnpm/yarn/pip/uv caches, journal/log files, Xcode data, editor extensions, node_modules, Trash, crontab/systemd timer disk checks, or asks for a repeatable free-space cleanup workflow.

Works with any agent that supports SKILL.md skills.

What this skill can do

Runs commands on your computer

The author does not mention this. Expected for a coding skill.

Found in 15 places.

skills/free-my-disk/SKILL.md, line 17uname -a
skills/free-my-disk/SKILL.md, line 24bash scripts/audit_macos_disk.sh
skills/free-my-disk/SKILL.md, line 32bash scripts/audit_linux_disk.sh

Show 12 more

skills/free-my-disk/SKILL.md, line 40ssh my-server 'bash -s' < scripts/audit_linux_disk.sh
skills/free-my-disk/SKILL.md, line 47df -h /
skills/free-my-disk/SKILL.md, line 56df -h /
skills/free-my-disk/SKILL.md, line 111ssh my-server 'df -h /; df -ih /; uname -a; sudo journalctl --disk-usage 2>/dev/null || true; docker system df 2>/dev/null || true'
skills/free-my-disk/SKILL.md, line 117ssh my-server 'PROJECT_SCAN=1 bash -s' < scripts/audit_linux_disk.sh
skills/free-my-disk/SKILL.md, line 123ssh my-server 'sudo du -xhd 1 / 2>/dev/null | sort -h | tail -30'
skills/free-my-disk/SKILL.md, line 130ssh my-server 'sudo apt-get clean && sudo apt-get autoclean'
skills/free-my-disk/SKILL.md, line 150mkdir -p "$HOME/.local/state/free-my-disk"
skills/free-my-disk/SKILL.md, line 167brew cleanup
skills/free-my-disk/SKILL.md, line 177docker system prune -af
skills/free-my-disk/SKILL.md, line 187sudo apt-get clean
skills/free-my-disk/SKILL.md, line 203df -h /

Changes files outside its own folder

The author does not mention this.

Found in 2 places.

skills/free-my-disk/SKILL.md, line 150mkdir -p "$HOME/.local/state/free-my-disk"
skills/free-my-disk/SKILL.md, line 153printf '0 8 * * * PROJECT_SCAN=1 /absolute/path/to/audit_linux_disk.sh >> "$HOME/.local/state/free-my-disk/audit.log" 2>&1 # free-my-disk audit\n' >> /tmp/free-

Install

Paste this into your terminal. It downloads exactly the version we scanned, not whatever is newest.

if [ -e ~/.agents/skills/'free-my-disk' ] || [ -L ~/.agents/skills/'free-my-disk' ]; then echo 'A skill folder named free-my-disk already exists — not replacing it' >&2; false; else d=$(mktemp -d) && git clone --quiet --filter=blob:none --no-checkout 'https://github.com/wquguru/skills' "$d" && git -C "$d" checkout --quiet 'a432f940754e34ec8869b33ccf0790b4c53e08bd' -- 'skills/free-my-disk' && mkdir -p ~/.agents/skills && cp -R "$d"/'skills/free-my-disk' ~/.agents/skills/'free-my-disk' && rm -rf "$d"; fi

Codex reads ~/.agents/skills directly. For Claude Code, Cursor, Copilot, Gemini CLI, Antigravity or OpenCode, also link it. For Claude Code: ln -s ~/.agents/skills/'free-my-disk' ~/.claude/skills/'free-my-disk' (other agents: ~/.cursor/skills, ~/.copilot/skills, ~/.gemini/skills, ~/.gemini/config/skills, ~/.config/opencode/skills). Or install through the finder skill, which does both.

Badge for your README

The badge for wquguru/skills shows the score of its lowest-scoring skill.

SkillTrust badge for wquguru/skills

[![SkillTrust](https://zalavijaysinh.github.io/skilltrust/badges/wquguru/skills.svg)](https://zalavijaysinh.github.io/skilltrust/repos/wquguru/skills/)

Score history

Date	Version	Score
2026-11-07	`a432f94`	85