disk-hygiene_skill

This skill helps you reclaim disk space on macOS by auditing usage, cleaning caches, and triaging Downloads for faster, cleaner systems.

TypeScript

14

GitHub Stars

1

Bundled Files

2 months ago

Catalog Refreshed

4 months ago

First Indexed

Readme & install

Copy the install command, review bundled files from the catalogue, and read any extended description pulled from the listing source.

Installation

Preview and clipboard use veilstrat where the catalogue uses aiagentskills.

npx veilstrat add skill terrylica/cc-skills --skill disk-hygiene

SKILL.md12.3 KB

Overview

This skill helps macOS users audit disk usage, prune caches, detect stale large files, and triage the Downloads folder to free space quickly and safely. It focuses on developer caches (brew, npm, pip, cargo, Docker), forgotten files, and guided Downloads cleanup. The goal is measurable space reclamation with safe, re-downloadable actions.

How this skill works

The skill runs a phased workflow: a disk overview (df, du summaries), targeted cache audits and safe cleanup commands, a stale-file detector that finds large files not accessed in 180+ days, and a Downloads triage flow with categorized listings and multi-select choices. It also recommends and integrates fast disk analysis tools (dust, dua, gdu-go, ncdu) for interactive inspection and deletion.

When to use it

System running low on free disk space
After heavy development work that installs many caches or containers
When you want to locate old/forgotten large files (>50MB)
To safely clean developer caches (Homebrew, npm, pip, cargo, uv, Docker)
To triage and batch-clean the ~/Downloads folder

Best practices

Run a disk overview before making changes to target the biggest consumers first
Prefer safe, re-downloadable cache cleans (brew cleanup, npm/pip cache purge) over manual deletions
Limit stale-file scans with maxdepth and sensible exclusions to avoid long runs
Use interactive tools (dua, gdu-go) for careful deletion and recovery staging
Present choices to the user for Downloads cleanup rather than deleting automatically

Example use cases

Full disk audit: overview, cache cleanup, stale-file scan, present choices, execute selected cleanups, report space reclaimed
Cache-only maintenance: measure cache sizes, run safe cache cleans (brew, uv, pip, npm), report reclaimed space
Downloads triage: list files with dates and sizes, group by type, present multi-select options to move or delete
Forgotten file hunt: scan home for large files not accessed in 180+ days, group by type/location, offer deletion or relocation options

FAQ

No — recommended cache commands target recoverable artifacts (package caches, build caches). They can be re-downloaded or rebuilt. Be cautious with Docker prune and Trash operations which are irreversible.

How does the stale-file scan avoid false positives?

Scans exclude common system and repo directories, use access time thresholds (180+ days), and present findings for user confirmation before any deletion.