charles-storage-cleanup — Claude Code skill for Mac 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.
no license ★ 237 updated 2026-11-16
npx skills add LemonFace0309/charles-skills --skill charles-storage-cleanup -a claude-codeWhat charles-storage-cleanup 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.
What it helps with
- 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 for the agent
- 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.
How to install charles-storage-cleanup
1Skills CLI (Vercel)
npx skills add LemonFace0309/charles-skills --skill charles-storage-cleanup -a claude-code2Manually: put the files in place
~/.claude/skills/charles-storage-cleanup/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/charles-storage-cleanup/
1Skills CLI (Vercel)
npx skills add LemonFace0309/charles-skills --skill charles-storage-cleanup -a codex2Manually: put the files in place
.agents/skills/charles-storage-cleanup/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add LemonFace0309/charles-skills --skill charles-storage-cleanup -a cursor2Manually: put the files in place
.cursor/skills/charles-storage-cleanup/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install LemonFace0309/charles-skills skills/charles-storage-cleanup2Manually: put the files in place
.github/skills/charles-storage-cleanup/SKILL.md1Skills CLI (Vercel)
npx skills add LemonFace0309/charles-skills --skill charles-storage-cleanup -a gemini-cli2Platform CLI
gemini skills install https://github.com/LemonFace0309/charles-skills --path skills/charles-storage-cleanupManually: put the files in place
.devin/skills/charles-storage-cleanup/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about charles-storage-cleanup
How do I install charles-storage-cleanup in Claude Code?
Run npx skills add LemonFace0309/charles-skills --skill charles-storage-cleanup -a claude-code. The skill file is placed at ~/.claude/skills/charles-storage-cleanup/SKILL.md.
What does charles-storage-cleanup do?
It inspects Mac disk usage, identifies possible cleanup targets, and removes authorized disposable files while preserving active work.
Does charles-storage-cleanup need permission to delete files?
Yes. An inventory-only request stays read-only, and deletion is limited to what the user has authorized.