Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx skills add NikOneZ1/mac-space-cleaner --skill free-spacegit clone --depth 1 https://github.com/NikOneZ1/mac-space-cleanerWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/skills/nikonez1/mac-space-cleaner/free-space)<a href="https://agentmods.dev/skills/nikonez1/mac-space-cleaner/free-space"><img src="https://agentmods.dev/badge/skills/nikonez1/mac-space-cleaner/free-space/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/skills/nikonez1/mac-space-cleaner/free-space"><img src="https://agentmods.dev/badge/skills/nikonez1/mac-space-cleaner/free-space.svg" alt="Reviewed on agentmods" width="80" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00115 | $0.01639 |
| Opus 5 | $0.00057 | $0.00820 |
| Sonnet 5 | $0.00023 | $0.00328 |
| Haiku 4.5 | $0.00012 | $0.00164 |
Grade C, and why
free-space scanned grade C with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 9d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Recursive force deletehighDestructive command
rm -rf with a variable or a broad path is one typo away from removing the wrong tree.
7. **No broad/dangerous removes.** Never `rm -rf ~`, `~/Library`, `/`, or any How it starts
The opening of the file, as written. The whole thing — 128 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Free Up Space on macOS
Reclaim disk space safely and interactively. You scan first, show the user what's recoverable, and delete only what they explicitly approve.
This skill is for macOS only. If the OS is not Darwin, say so and stop.
Golden rules — never break these
- Scan before you delete. Always run the scanner and show the report first.
- Confirm every deletion group with the user before removing anything. Use
AskUserQuestionwith multi-select. Never delete on your own initiative. - Never touch user data. Off-limits, no exceptions:
~/Documents,~/Desktop,~/Pictures/Photos Library,~/Movies,~/Music, iCloud Drive, Mail, Messages, Keychains,~/.ssh,~/.gnupg,.envfiles, password stores, and the only copy of any iOS/Time-Machine backup. - Cache ≠ data. Only delete things that regenerate (caches, build artifacts) or are re-downloadable (model weights, package caches), or data belonging to apps the user has uninstalled.
- Verify "orphans." The scanner's uninstalled-app list is a heuristic.
Before deleting any app's leftover data, confirm the app is really gone
(
ls /Applications "$HOME/Applications" /Applications/Utilities). Shared vendor folders are traps — e.g.Googleis Chrome's, not orphaned. - Warn about running apps. Clearing an app's cache while it runs can glitch it. Tell the user to quit it first (Electron apps especially). Never force-quit.
- No broad/dangerous removes. Never
rm -rf ~,~/Library,/, or any path with an unexpanded variable. Delete specific, named paths only. Quote paths with spaces. Never usesudo. - Docker disk image: never delete
Docker.rawdirectly — it wipes containers/volumes. Only suggest Docker Desktop → Settings → Resources → Purge data, ordocker system prunefor unused images. - Prefer reversible. When unsure and the item is small, move to
~/.Trashinstead ofrmso the user can recover it.
What ships with it
1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 9d ago First seen · 128 lines · 115 tokens per session scan C 8eace0d7e322
free-space is a skill published in the GitHub repository NikOneZ1/mac-space-cleaner (2 stars, last pushed 3mo ago), licensed MIT. It adds 115 tokens to every session and 1,639 once invoked, about $0.0006 per session on Opus 5. A static security scan graded it C with 1 finding (recursive force delete). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.
Other skills, from other repositories
claude-code-bash-patterns
Claude Code Bash tool patterns with hooks, automation, git workflows. Use for PreToolUse hooks, command chaining, CLI orchestration, custom commands, or encountering bash permissions, command failures, security guards, hook configurations.
storage-analyzer
A read-only disk-space scanner for macOS and Windows that groups files into categories such as caches, personal data, and files to keep. It produces an HTML report with commands you can review before cleanup.
sitrep-panel
Keep a live local HTML report updated as you work on a task — a status board, a running "what's happening now" narrative, screenshots, and a newest-first log — served on localhost so the user can watch progress in a browser tab instead of reading the transcript. Use when the user invokes /sitrep-panel, asks for a…
xcode-disk-cleanup
Audit and safely clean Xcode-related developer storage on macOS. Use whenever a developer mentions low disk space, Xcode storage, DerivedData, simulator devices or runtimes, stale beta platforms in Xcode Settings, DeviceSupport, archives, dSYMs, CocoaPods caches, simulator dyld caches, project .build folders…
promote
Turn a scratch script into a permanent tool this repo keeps. Use when a check, report, or analysis has proved worth running more than once.
parallel-session-coedit-via-source-mtime-and-idempotent-rebuild
Edit a shared deliverable while another live session or a colleague's agent is editing the same file right now — "don't delete each other's work", "only write when the other one is finished". When the file is built from many per item sources by an assembler (sections into one HTML, slides, reports): source mtime shows…