mole — Claude Code skill for disk cleanup
This Claude Code skill operates Mole CLI on macOS and Windows. It checks disk usage, previews cleanup actions, and reads system status and cleanup history.
GPL-3.0 1,600 installs ★ 75,794 updated 2026-11-16
npx skills add tw93/Mole --skill mole -a claude-codeWhat mole does
The skill runs Mole (mo) commands to inspect disk usage, check system health, review cleanup history, and list apps for removal. It reads command output first and presents a preview with sizes and the affected groups before any cleanup.
Removal requires approval after the preview. Cleanup commands do not offer item-by-item selection, while app removal and administrator-level actions must be completed in the user’s terminal. Mole CLI (mo) and a local shell on macOS or Windows are required. The skill is for operating Mole, not changing its source code.
What it helps with
- identify what is taking up disk space
- preview the items and sizes targeted by cleanup
- check Mole’s cleanup history
- find an app in Mole’s uninstall list
Example prompts for the agent
- Show what is using disk space and preview the cleanup plan.
- Check what Mole removed earlier.
- Find an app in the uninstall list and tell me what to run in my terminal.
How to install mole
1Skills CLI (Vercel)
npx skills add tw93/Mole --skill mole -a claude-code2Manually: put the files in place
~/.claude/skills/mole/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/mole/
1Skills CLI (Vercel)
npx skills add tw93/Mole --skill mole -a codex2Manually: put the files in place
.agents/skills/mole/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add tw93/Mole --skill mole -a cursor2Manually: put the files in place
.cursor/skills/mole/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install tw93/Mole skills/mole2Manually: put the files in place
.github/skills/mole/SKILL.md1Skills CLI (Vercel)
npx skills add tw93/Mole --skill mole -a gemini-cli2Platform CLI
gemini skills install https://github.com/tw93/Mole --path skills/moleManually: put the files in place
.devin/skills/mole/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add tw93/Mole --skill mole -a opencodeClaude.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 mole
How do I install mole in Claude Code?
Run npx skills add tw93/Mole --skill mole -a claude-code. The skill file is at ~/.claude/skills/mole/SKILL.md.
What does mole do?
It operates Mole CLI to inspect disk usage, view cleanup previews and history, and list apps for removal. Cleanup requires approval after the preview.
What does mole need to run?
It requires Mole CLI (mo) and a local shell on macOS or Windows. App removal and administrator-level actions must be run in the user’s terminal.