Skip to content
Skills Library
Personal productivity · Automation

disk

/disk

Use when disk is full, no space left, or to free up space: find big dirs, decide if Claude sessions or npm cache are safe to delete, shrink WSL vhdx.

Author
tony ↗
Repository
skills ↗
Licence
MIT
Last repository change
25.10.2026

Assessment and security

90/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content25 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
3
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 25.10.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Use when disk is full, no space left, or to free up space: find big dirs, decide if Claude sessions or npm cache are safe to delete, shrink WSL vhdx.

Original author description

Use when disk is full, no space left, or to free up space: find big dirs, decide if Claude sessions or npm cache are safe to delete, shrink WSL vhdx.

How it works

  1. Non-negotiables
  2. Route
  3. Portability notes
Original SKILL.md headings · 59 lines, 489 words
SKILL.md preview
---
name: disk
description: >-
  Use when disk is full, no space left, or to free up space: find big dirs,
  decide if Claude sessions or npm cache are safe to delete, shrink WSL
  vhdx.
allowed-tools: "Bash, Read, Glob, Grep, AskUserQuestion, TodoWrite"
metadata:
  argument-hint: "[path or filesystem to focus on]"
  source: "plugins/disk/skills/disk/SKILL.md"
---

# Disk

Find what is consuming a machine's disk and reclaim it without losing
anything the user cannot get back.

## Non-negotiables

- **Never halt the environment.** `wsl --shutdown`, `wsl --terminate`, VM
  stop commands, and container-runtime restarts are the user's to run.
  Say what it interrupts, print the command in a `powershell` fence
  inside the blocked shape of `references/output-contract.md`, and
  stop. Approval to delete caches is not approval to terminate the
  environment, and neither is an explicit "run it yourself". State the
  refusal as policy ("I won't run it; you run it"), not as a sandbox or
  tool limit.
- **Never delete on the strength of a name.** `*-backup-*`, `.old`,
  `.bak`, and `archive-*` say nothing about redundancy. Run the proof.
- **Agent history is protected.** Reclaim from it only through the owning
  tool's archival path, or by proving one copy redundant against another.
- **Report guest and host separately.** Guest free space and a backing
  file's apparent size do not measure host recovery; measure the host too.
- **Report only what was measured.** Never say where unmeasured space
  probably is, size the unread remainder (including used minus measured),
  guess which layer is the cause, describe an unmeasured path by its
  contents, or claim that TRIM or a `discard` mount option returns guest
  deletions to the host. Forbidden phrasings: "which I'd expect to hold
  most of it", "almost all of the used space is outside what I could
  read", "likely in your home directory", "the rest is elsewhere on this
  filesystem", "I tried to read ~/.cache and none of it could be read" when only
  the home directory was attempted.
- **Linux and WSL only.** macOS is unsupported: report APFS snapshots and
  purgeable space as unmeasured, and say the guard's mount check there
  lacks the Linux mountinfo layer. Native Windows is untested.
- **Never run `sudo`.** Print the full command for the user and stop.
  Introduce it as "run this in your own shell", never as "it needs
  root, so I won't run it myself".
  This covers system-tier cleanup such as `apt clean` and
  `journalctl --vacuum-size`.
- **A blanket approval covers only the regenerable tier.** Data without a
  proved replacement is decided per directory.

## Route

Open the sibling file with the Read tool and follow it. Each sibling opens with a scope
line. Use the path the user named, or every mounted filesystem when none;
reading the file does not set it.

- Survey, "where did my space go", or no request to delete: follow
  the `disk-usage` skill. It is read-only, and the router run does not end
  with an offer to reclaim.
- Free space, clean up, or shrink WSL: follow the `disk-usage` skill, then
  the `disk-reclaim` skill, which reuses that survey instead of repeating it.


## Portability notes

- Bundled files — every relative path in this skill points at a file shipped inside this skill directory. Read them from here, not from the host's plugin tree.
Files in this package (3)
  • SKILL.md 3 KB
  • agents/openai.yaml 1 KB
  • references/output-contract.md 14 KB

Versions

RepositoryScoreLicence
This page · tony/skills90MIT
tony/skills90MIT
hamzahamidi/agentdust81MIT

Database snapshot: 13.11.2026 · package version 39f2a5c9ecb9 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100cleanup
    Free up disk space on this computer: list what takes space with its size, why it is safe to delete and what it costs, then delete only what the owner picks. Use when someone says "cleanup", "clean up disk", "free up space", "my disk is full", "out of space", "the Mac is full",…
  • 90free-up-disk-space
    Free up disk space on the user's Mac safely with DiskSpace AI. Use when the user says their Mac or disk is full, asks what's taking up space, can't install a macOS update, wants to clean caches, Xcode DerivedData, simulators, Docker, node_modules or AI models, or asks whether a…
  • 100computer-clean
    Audit and reclaim disk space on macOS. Discovers cache hogs, dev caches, dead app data, old Downloads, dup installers, obsolete container images and volumes, merged worktrees, and stale node_modules/.venv dirs. Use when user says 'clean disk', 'free up space', 'computer-clean',…
  • 91status
    One-second disk space check: free space, two-week trend, last scan and cleanup. Use when asked how much disk space is left or whether a cleanup is needed. Reads saved state only; scans and changes nothing.
  • 90disk-cleanup
    Audit disk usage, free disk space, clean up disposable files, and recommend ways to limit storage growth. Use for hard disk cleanup, low disk space, large caches, or finding what consumes storage.
  • 100genizah
    Safely free up disk space on a Mac, Windows PC or Linux machine, step by step, with the user's approval before anything is deleted and an extra warning before anything important goes. Use this whenever the user says their computer, laptop or disk is full, low on storage,…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.