# charles-storage-cleanup

The charles-storage-cleanup Claude Code skill inspects Mac disk usage and removes disposable files once authorized. An inventory-only request leaves files untouched.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 237 repo stars
- Author: LemonFace0309
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/LemonFace0309/charles-skills/tree/HEAD/skills/charles-storage-cleanup/SKILL.md
- Updated: 2026-11-16
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/charles-storage-cleanup

## What it does

The skill measures free space on a Mac volume, finds large folders, and checks which files can be removed without disturbing active work. It reviews apps, caches, development environments, devices, and other storage sources. Broad audits follow a discovery checklist.

Before removing files, it checks running processes, open files, and active devices, then records paths, sizes, and cleanup reasons. Active apps, builds, and uncommitted changes stay in place. Deletion requires authorization; a request to inspect the disk does not grant it.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add LemonFace0309/charles-skills --skill charles-storage-cleanup -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/charles-storage-cleanup/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/charles-storage-cleanup/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add LemonFace0309/charles-skills --skill charles-storage-cleanup -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/charles-storage-cleanup/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add LemonFace0309/charles-skills --skill charles-storage-cleanup -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/charles-storage-cleanup/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install LemonFace0309/charles-skills skills/charles-storage-cleanup
```

2. **Manually: put the files in place**
- File: `.github/skills/charles-storage-cleanup/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add LemonFace0309/charles-skills --skill charles-storage-cleanup -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/LemonFace0309/charles-skills --path skills/charles-storage-cleanup
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/charles-storage-cleanup/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/LemonFace0309/charles-skills/tree/HEAD/skills/charles-storage-cleanup/SKILL.md

## When to use it
- locate large folders taking up Mac disk space
- separate removable caches from active project data
- trace why free space drops again after cleanup
- list deletion candidates with paths and measured sizes

## Example prompts
- Audit Mac disk usage and list candidates for cleanup.
- Remove confirmed disposable caches and development environments while preserving active projects.
- Find out why free disk space drops again after cleanup.

## Similar
- [windows-app-storage-inspector-cleanup](https://affpapa.org/en/nevibecode/plugins/windows-app-storage-inspector-cleanup.md) — plugin · ★ 41430 repo stars
- [design-cleanup](https://affpapa.org/en/nevibecode/skills/design-cleanup.md) — skill · 4400 installs
- [launchdarkly-flag-cleanup](https://affpapa.org/en/nevibecode/skills/launchdarkly-flag-cleanup.md) — skill · 4200 installs
- [neon-object-storage](https://affpapa.org/en/nevibecode/skills/neon-object-storage.md) — skill · 46500 installs
- [extension-object-storage](https://affpapa.org/en/nevibecode/skills/extension-object-storage.md) — skill · 32200 installs
- [huawei-cloud-storage-query](https://affpapa.org/en/nevibecode/skills/huawei-cloud-storage-query.md) — skill · 18300 installs

From the same set: [lemonface0309/charles-skills](https://affpapa.org/en/nevibecode/by/lemonface0309/charles-skills.md) — 13 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
