Agent skill

Free Disk Space

by OutThisLife in OutThisLife/brooklyn-skills

Safely reclaim disk space on macOS without touching personal or agent data.

MITAuto-check passed

Install Free Disk Space

skills CLI
$ npx skills add OutThisLife/brooklyn-skills --skill free-disk-space -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install OutThisLife/brooklyn-skills free-disk-space --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/OutThisLife/brooklyn-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/free-disk-space .claude/skills/free-disk-space && rm -rf skills-src

Use ~/.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/

Facts

Skill name
free-disk-space
GitHub stars
199
Token cost
~433 tokens
SKILL.md length
199 words
Files
1
Skills in repo
22
Repo updated
First seen
Licence
MIT

At a glance

Safely reclaim disk space on macOS without touching personal or agent data.

  • Works in 6 steps: Record current usage from the macOS data… → Find the largest consumers before… → Explain what is large, whether it is… → …
  • The user asks to free disk space
  • SKILL.md covers Safety and Workflow
  • Calls pnpm

What it does

Free Disk Space is an agent skill from OutThisLife/brooklyn-skills. Safely reclaim disk space on macOS without touching personal or agent data. Use when the user asks to free disk space, clear caches, or investigate a nearly full Mac.

Its SKILL.md is about 430 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It works with macOS. The repository describes itself as: Skills that drive best-in-class engineering. The licence is MIT.

When your agent uses it

  • The user asks to free disk space
  • Investigate a nearly full Mac

Example prompts

  • “/free-disk-space”

Requirements

  • Docker

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. Record current usage from the macOS data volume
  2. Find the largest consumers before deleting anything. Use du, package
  3. Explain what is large, whether it is regenerable, and the expected impact.
  4. Clean only safe targets
  5. For sparse files such as Docker's virtual disk, report actual disk use from
  6. Record usage again and report space freed.

What it can do on your machine

Read from SKILL.md and the folder at commit 8a97904. 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:

    • pnpm

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use pnpm, 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 433 tokens when it runs. Until then it costs about 46 tokens; SKILL.md has 199 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~46
When it runs · the whole SKILL.md, loaded when a task matches
~433

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 OutThisLife/brooklyn-skills at commit 8a97904, republished under its MIT licence (© OutThisLife). 199 words, ~433 tokens.

Download SKILL.mdSave it as .claude/skills/free-disk-space/SKILL.md (or your agent's skills folder).
name
free-disk-space
description
Safely reclaim disk space on macOS without touching personal or agent data. Use when the user asks to free disk space, clear caches, or investigate a nearly full Mac.

Free Disk Space

Investigate first. Delete only regenerable data the user has authorized.

Safety

  • Never inspect, delete, or modify the data of the IDE or agent you're running inside — its application-support dir, caches, globalStorage, databases, extensions, or logs — unless the user explicitly names it as a cleanup target. On macOS that lives under ~/Library/Application Support/<app>/ (e.g. .../Cursor/).
  • Never delete browser history, extensions, cookies, credentials, local storage, IndexedDB, bookmarks, passwords, or user-created files.
  • Ask before destructive cleanup such as deleting Docker images, containers, volumes, or virtual disks.

Workflow

  1. Record current usage from the macOS data volume:

    bash
    df -h /System/Volumes/Data
  2. Find the largest consumers before deleting anything. Use du, package manager diagnostics, and application-specific storage commands. Do not descend into protected agent/IDE data.

  3. Explain what is large, whether it is regenerable, and the expected impact.

  4. Clean only safe targets:

    • contents of ~/Library/Caches/
    • unused package-manager cache entries, such as pnpm store prune
    • known browser model/GPU caches, never browser profile data
  5. For sparse files such as Docker's virtual disk, report actual disk use from du, not apparent size from ls.

  6. Record usage again and report space freed.

Do not represent the sealed / system volume as the Mac's usable data-volume capacity.

© OutThisLife, 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 OutThisLife/brooklyn-skills.

Open the folder on GitHubat commit 8a97904

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.

Free Disk Space compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Free Disk Space this skillOutThisLife/brooklyn-skills199—~433Automated safety check: PassMIT
Site ArchitectureAvdLee/RocketSimApp80411 repos~3.3kAutomated safety check: PassCustom licence
Engine Whats Newflutter/flutter179k—~978Automated safety check: PassBSD-3-Clause
macOS Spm App PackagingDimillian/Skills4k5 repos~1.2kAutomated safety check: PassMIT
Openclaw Live Updateropenclaw/openclaw392k—~3.7kAutomated safety check: PassMIT
Orca iOS Simulator Controlstablyai/orca88k1 repos~584Automated safety check: PassApache-2.0

Similar skills

  • Site Architecture

    AvdLee/RocketSimApp

    When the user wants to plan, map, or restructure their website's page hierarchy, navigation, URL structure, or internal linking.

    804 GitHub starsUsed in 11 repos~3.3k tokens
    Marketing & SEOAuto-check passed
  • Engine Whats New

    flutter/flutter

    Generates the "what's new" release summary and diff file for changes in the Flutter engine (//engine/src/flutter) between two releases (e.g., 3.47 vs 3.44).

    179k GitHub stars~978 tokensUpdated today
    MobileAuto-check passed
  • macOS Spm App Packaging

    Dimillian/Skills

    Scaffold, build, and package SwiftPM-based macOS apps without an Xcode project.

    4k GitHub starsUsed in 5 repos~1.2k tokens
    MobileAuto-check passed
  • Openclaw Live Updater

    openclaw/openclaw

    Maintain the canonical live OpenClaw main checkout, macOS LaunchAgent-managed Gateway, local macOS app, exact-head main CI, and recurring full release validation.

    392k GitHub stars~3.7k tokensUpdated today
    DevOps & CloudAuto-check passed
  • iOS Simulator control from inside Orca, with the live device view in Orca's emulator pane. Use when driving a booted Apple Simulator on macOS: taps, gestures…

    88k GitHub starsUsed in 1 repo~584 tokens
    MobileAuto-check passed
  • A catalog of recurring bug shapes in the Mole Mac cleaner, used to review safety-sensitive diffs for deletion safety, unbounded commands, shell traps and weak tests.

    70k GitHub stars~2k tokensUpdated yesterday
    DevelopmentAuto-check passed

More from OutThisLife/brooklyn-skills

All 22 skills in this repo
  • Draft Tweet

    OutThisLife/brooklyn-skills

    Draft X/Twitter posts about shipped work. An agent skill from OutThisLife/brooklyn-skills.

    199 GitHub stars~456 tokensUpdated 4 days ago
    Auto-check passed
  • List Open Work

    OutThisLife/brooklyn-skills

    List my open MRs/PRs in the current repo/worktree, each with its tracker ticket.

    199 GitHub stars~1.5k tokensUpdated 4 days ago
    Auto-check passed
  • PR Ready

    OutThisLife/brooklyn-skills

    Clear everything blocking an existing PR/MR from merging — rebase onto the default branch, get CI green, and resolve review threads (Copilot and human).

    199 GitHub stars~2.5k tokensUpdated 4 days ago
    Auto-check passed
  • PR Triage

    OutThisLife/brooklyn-skills

    Maintainer triage on OTHER people's PRs/MRs — verdict of approve, supersede, or close, salvage with credit, close the cluster.

    199 GitHub stars~4.7k tokensUpdated 4 days ago
    Auto-check passed
  • PR Update

    OutThisLife/brooklyn-skills

    Open a PR/MR if missing, or refresh an existing one's title and description so they match the current diff.

    199 GitHub stars~1.3k tokensUpdated 4 days ago
    Auto-check: notes
  • Work

    OutThisLife/brooklyn-skills

    Kick off a task in a fresh isolated git worktree instead of the current checkout.

    199 GitHub stars~858 tokensUpdated 4 days ago
    Auto-check passed

Works with

Questions about Free Disk Space

What does Free Disk Space do?

Safely reclaim disk space on macOS without touching personal or agent data. Free Disk Space is an agent skill from OutThisLife/brooklyn-skills. Safely reclaim disk space on macOS without touching personal or agent data.

When should I use Free Disk Space?

Free Disk Space fits situations like: the user asks to free disk space; investigate a nearly full Mac.

How do I install Free Disk Space in Claude Code?

Run `npx skills add OutThisLife/brooklyn-skills --skill free-disk-space -a claude-code`. Or copy the skill folder (skills/free-disk-space in OutThisLife/brooklyn-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 OutThisLife/brooklyn-skills --skill free-disk-space -a codex`. Or copy the skill folder (skills/free-disk-space in OutThisLife/brooklyn-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 OutThisLife/brooklyn-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 (pnpm). Our summary lists: Docker.

Does Free Disk Space access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. 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 433 tokens (SKILL.md is roughly 1.7k 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: Site Architecture (AvdLee/RocketSimApp, 804 stars), Engine Whats New (flutter/flutter, 179k stars), macOS Spm App Packaging (Dimillian/Skills, 4k stars) and Openclaw Live Updater (openclaw/openclaw, 392k 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?

OutThisLife (a GitHub user) maintains it in OutThisLife/brooklyn-skills, which has 199 GitHub stars. The repository holds 22 skills in this directory. The repository was last updated on October 5, 2026.

Source: OutThisLife/brooklyn-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.