Build Px4 macOS
PX4/PX4-Autopilot
Build PX4 board firmware on macOS in the px4-dev Docker container, including git worktrees, and stage commit-labeled artifacts without flashing hardware.
Reclaim disk space on macOS by auditing and clearing build artifacts, package-manager caches, stale git worktrees, and offloading large media to an external drive.
Install Free Disk Space
$ npx skills add bholmesdev/skills --skill free-disk-space -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install bholmesdev/skills free-disk-space --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/bholmesdev/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/free-disk-space .claude/skills/free-disk-space && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "free-disk-space" agent skill from https://github.com/bholmesdev/skills/tree/main/skills/free-disk-space into .claude/skills/free-disk-space/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "free-disk-space", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/bholmesdev/skills/tree/main/skills/free-disk-spaceType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add bholmesdev/skills --skill free-disk-space -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install bholmesdev/skills free-disk-space --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/bholmesdev/skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/free-disk-space .agents/skills/free-disk-space && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "free-disk-space" agent skill from https://github.com/bholmesdev/skills/tree/main/skills/free-disk-space into .agents/skills/free-disk-space/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "free-disk-space", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add bholmesdev/skills --skill free-disk-space -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install bholmesdev/skills free-disk-space --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/bholmesdev/skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/free-disk-space .cursor/skills/free-disk-space && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "free-disk-space" agent skill from https://github.com/bholmesdev/skills/tree/main/skills/free-disk-space into .cursor/skills/free-disk-space/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "free-disk-space", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/bholmesdev/skills.git --path skills/free-disk-space--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add bholmesdev/skills --skill free-disk-space -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install bholmesdev/skills free-disk-space --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/bholmesdev/skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/free-disk-space .gemini/skills/free-disk-space && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "free-disk-space" agent skill from https://github.com/bholmesdev/skills/tree/main/skills/free-disk-space into .gemini/skills/free-disk-space/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "free-disk-space", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install bholmesdev/skills free-disk-spaceInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add bholmesdev/skills --skill free-disk-space -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/bholmesdev/skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/free-disk-space .github/skills/free-disk-space && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "free-disk-space" agent skill from https://github.com/bholmesdev/skills/tree/main/skills/free-disk-space into .github/skills/free-disk-space/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "free-disk-space", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add bholmesdev/skills --skill free-disk-space -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install bholmesdev/skills free-disk-space --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/bholmesdev/skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/free-disk-space .opencode/skills/free-disk-space && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "free-disk-space" agent skill from https://github.com/bholmesdev/skills/tree/main/skills/free-disk-space into .opencode/skills/free-disk-space/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "free-disk-space", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
free-disk-space- GitHub stars
- 177
- Token cost
- ~623 tokens
- SKILL.md length
- 292 words
- Files
- 1
- Skills in repo
- 4
- Repo updated
- First seen
- Licence
- MIT
At a glance
Reclaim disk space on macOS by auditing and clearing build artifacts, package-manager caches, stale git worktrees, and offloading large media to an external drive.
- Works in 6 steps: Assess → Survey → Clear safe tier without asking → …
- The user complains about low storage
- SKILL.md covers Ground rules and Workflow
- Calls git, go and brew
What it does
Free Disk Space is an agent skill from bholmesdev/skills. Reclaim disk space on macOS by auditing and clearing build artifacts, package-manager caches, stale git worktrees, and offloading large media to an external drive. Use whenever the user complains about low storage, a full disk, "out of space" errors, or asks to clean up, offload, or free up their machine — even if they don't name specific folders.
Its SKILL.md is about 620 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It sits in Development, covering Git worktrees. It works with macOS. The licence is MIT.
When your agent uses it
- The user complains about low storage
- Out of space errors
- Asks to clean up
- Free up their machine — even if they dont name specific folders
Example prompts
- “out of space”
- “/free-disk-space”
Workflow steps
6 steps, taken from the step headings in SKILL.md.
What it can do on your machine
Read from SKILL.md and the folder at commit 44da67b. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
gitgobrewpnpmnpmcargorsync
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md. Its commands use git, pnpm, npm and rsync, which can reach the network depending on how they are called.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Free Disk Space loads about 623 tokens when it runs. Until then it costs about 91 tokens; SKILL.md has 292 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from bholmesdev/skills at commit 44da67b, republished under its MIT licence (© bholmesdev). 292 words, ~623 tokens.
Download SKILL.mdSave it as
.claude/skills/free-disk-space/SKILL.md (or your agent's skills folder).- name
- free-disk-space
- description
- Reclaim disk space on macOS by auditing and clearing build artifacts, package-manager caches, stale git worktrees, and offloading large media to an external drive. Use whenever the user complains about low storage, a full disk, "out of space" errors, or asks to clean up, offload, or free up their machine — even if they don't name specific folders.
Free Disk Space (macOS)
Audit the disk, clear what's safely regenerable, and confirm before touching anything that isn't.
Ground rules
- Use
trash(if the CLI is available) instead ofrm -rf. Accumulate in Trash; ask the user to empty it once at the end. - Prefer a tool's own cleanup command over deleting its directories (
go clean -cache,brew cleanup --prune=all,pnpm store prune,npm cache clean --force,cargo clean). - Measure with
df -h /System/Volumes/Data(not plaindf /). - Do not clear GUI app data.
~/Library/Caches/<App>and~/Library/Application Support/<App>often hold logins, cookies, and history. Leave them alone unless the user names a specific app and accepts the risk. Prefer build cleanup, package-manager prune, stale worktrees, and external-drive offload instead.
Workflow
1. Assess
df -h /System/Volumes/Data; ls /Volumes. Note free space and whether an external drive is mounted.
2. Survey
Targeted du -sh ... | sort -hr — not a full scan of ~. Usual big ones:
- Build artifacts:
target/(every worktree too),node_modules/, Xcode DerivedData - Package-manager caches: go-build, Homebrew, pnpm/npm/pip stores — clean via CLI
- Large media: CapCut, Screen Studio, Movies, Downloads
- Report app caches / Application Support sizes only; don't auto-delete them
3. Clear safe tier without asking
Build artifacts and package-manager / language-tool caches only. Everything else (app data, media, model weights, toolchains): summarize sizes and ask, or propose offload.
4. Audit git worktrees
For each worktree: dirty? unique/unpushed commits? Clean + fully merged/pushed → git worktree remove and git branch -d (never -D). Keep and report anything dirty or ahead.
5. Offload keepers
rsync -a → verify sizes → trash original → symlink old path. Symlink individual folders, not whole special dirs like ~/Movies. Warn the app needs the drive mounted.
6. Wrap up
What freed immediately, what's in Trash, what you left alone. Ask user to empty Trash and re-check df.
© bholmesdev, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
Just SKILL.md in skills/free-disk-space of bholmesdev/skills.
Open the folder on GitHubat commit 44da67b
Compare with similar skills
Free Disk Space next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Free Disk Space this skillbholmesdev/skills | 177 | — | ~623 | Automated safety check: Pass | MIT | |
| Build Px4 macOSPX4/PX4-Autopilot | 13k | — | ~1.1k | Automated safety check: Pass | BSD-3-Clause | |
| Git Worktree Setupk8zdev/k8z | 155 | — | ~930 | Automated safety check: Pass | None | |
| Mori Agent Bridgevaayne/mori | 303 | — | ~1.7k | Automated safety check: Pass | MIT | |
| Liney CLIeverettjf/liney | 150 | — | ~1.2k | Automated safety check: Notes | Apache-2.0 | |
| Migrate Core Code to Submodulestinyhumansai/openhuman | 42k | — | ~2.6k | Automated safety check: Pass | GPL-3.0 |
Similar skills
Git Worktree Setup
k8zdev/k8z
Automate git worktree creation and copy private files (not tracked in git) to new workdirs.
Mori Agent Bridge
vaayne/mori
Use Mori CLI to enable agent-to-agent communication and coordination across Mori-managed panes.
Liney CLI
everettjf/liney
Use the Liney CLI (liney) to inspect or control a running Liney terminal workspace and the agent sessions it hosts.
Migrate Core Code to Submodules
tinyhumansai/openhuman
Plans and carries out moving non-host-specific code and its tests from the OpenHuman core into vendored tiny submodule libraries, then releases the submodule and re-pins the host.
Worktree
AgentsMesh/AgentsMesh
Creates or reuses an isolated AgentsMesh Git worktree from a verified base branch, preserves existing changes, and optionally starts the worktree-scoped development environment.
More from bholmesdev/skills
Transcribe
bholmesdev/skills
Create clean, subtitle-ready .srt subtitles for a local audio or video file using Whisper CLI.
Alt Text
bholmesdev/skills
Write concise alt text for a local image file. An agent skill from bholmesdev/skills.
Done
bholmesdev/skills
When we finish a feature. An agent skill from bholmesdev/skills.
Related
Works with
Categories
Questions about Free Disk Space
What does Free Disk Space do?
Reclaim disk space on macOS by auditing and clearing build artifacts, package-manager caches, stale git worktrees, and offloading large media to an external drive. Free Disk Space is an agent skill from bholmesdev/skills. Reclaim disk space on macOS by auditing and clearing build artifacts, package-manager caches, stale git worktrees, and offloading large media to an external drive.
When should I use Free Disk Space?
Free Disk Space fits situations like: the user complains about low storage; out of space errors; asks to clean up; free up their machine — even if they dont name specific folders.
How do I install Free Disk Space in Claude Code?
Run `npx skills add bholmesdev/skills --skill free-disk-space -a claude-code`. Or copy the skill folder (skills/free-disk-space in bholmesdev/skills) into .claude/skills/free-disk-space in your project. Claude Code loads it when a task matches its description.
How do I install Free Disk Space in Codex?
Run `npx skills add bholmesdev/skills --skill free-disk-space -a codex`. Or copy the skill folder (skills/free-disk-space in bholmesdev/skills) into .agents/skills/free-disk-space in your project. Codex loads it when a task matches its description.
Can I use Free Disk Space in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add bholmesdev/skills --skill free-disk-space -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/free-disk-space, .gemini/skills/free-disk-space, .github/skills/free-disk-space and .opencode/skills/free-disk-space in your project.
What does Free Disk Space need to run?
Going by SKILL.md and its folder, Free Disk Space needs the command-line tools its instructions call (git, go, brew, pnpm, npm and cargo).
Does Free Disk Space access the network?
SKILL.md contains no URLs. Its commands use git and npm, which can reach the network depending on how they are called. This is read from the text; nothing was executed.
Is Free Disk Space safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Free Disk Space use?
Free Disk Space is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Free Disk Space use?
About 623 tokens (SKILL.md is roughly 2.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Free Disk Space?
Skills that share tags, products or a category with Free Disk Space: Build Px4 macOS (PX4/PX4-Autopilot, 13k stars), Git Worktree Setup (k8zdev/k8z, 155 stars), Mori Agent Bridge (vaayne/mori, 303 stars) and Liney CLI (everettjf/liney, 150 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Free Disk Space?
bholmesdev (a GitHub user) maintains it in bholmesdev/skills, which has 177 GitHub stars. The repository holds 4 skills in this directory. The repository was last updated on August 7, 2026.
Source: bholmesdev/skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.