disk-cleanup

Identify large and stale files on macOS and reclaim disk space safely.

Updated Apr 19, 2026
One-click install
npx skills add https://github.com/GDKennell/disk-cleanup-skill --skill disk-cleanup-gdkennell
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: disk-cleanup
Source: https://github.com/GDKennell/disk-cleanup-skill/tree/main
Command: npx skills add https://github.com/GDKennell/disk-cleanup-skill --skill disk-cleanup-gdkennell

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Disk space on macOS developers' laptops is consumed by Xcode caches, node_modules, and forgotten build artifacts. This skill guides users through a fast, transparent, staged workflow to identify reclaimable space and perform safe cleanups with explicit confirmations.

Core Features & Use Cases

  • Preflight: quick overview of disk usage and a scoped plan
  • Developer hotspots: targeted scans of known space hogs (Xcode caches, npm/pnpm/yarn caches, APFS snapshots, etc.)
  • Categorization and safe cleanup: group results into Safe / Review / Don't touch with per-category reclaim estimates
  • Go deeper or full scan on demand: optional stale-files or full disk analyses with explicit consent

Quick Start

Tell Claude Code to perform a fast preflight and then run the developer hotspots scan.

Frequently Asked Questions about disk-cleanup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I safely clean up Xcode caches and node_modules on macOS to reclaim disk space?

To safely reclaim disk space from Xcode caches and node_modules on macOS, use a staged cleanup workflow that performs a preflight scan, categorizes files into Safe and Review groups, and moves deleted items to the Trash rather than permanently removing them.

What is consuming the most disk space in my macOS developer environment?

Disk space on macOS developer laptops is typically consumed by Xcode caches, npm/yarn caches, Docker layers, and forgotten node_modules build artifacts. A fast preflight scan can identify these developer hotspots and provide a scoped reclaim plan.

Can I use a disk cleanup tool to scan Docker and npm caches without accidentally deleting important files?

Yes, safe disk cleanup is possible by grouping scan results into Safe, Review, and Don't touch categories with per-category reclaim estimates. This ensures explicit confirmation is required before deleting any files, preventing accidental removal of important data.

What's the best way to find and remove stale build artifacts on a macOS laptop?

The best way to find stale build artifacts on macOS is running an optional deep scan or full disk analysis after a preflight check. This identifies large, stale files across developer hotspots and requires explicit consent before performing any categorized cleanup.

Does macOS disk cleanup support APFS snapshots and pnpm caches?

Yes, macOS disk cleanup targets known space hogs including APFS snapshots and pnpm caches. The scanner categorizes these developer hotspots during the preflight phase and provides per-category reclaim estimates before any deletion occurs.

When should I avoid running a full disk scan for stale files on macOS?

You should avoid running a full disk scan when you only need a quick overview. The staged workflow recommends starting with a fast preflight and targeted developer hotspots scan, only escalating to a full disk analysis for stale files with explicit consent.