puremac-macos-cleaner — Claude Code skill: features and install
This skill guides coding agents through building PureMac, adding custom cleanup targets, and automating macOS system maintenance with zero telemetry.
npx skills add reason-machines/trending-skills --skill puremac-macos-cleaner -a claude-codeWhat puremac-macos-cleaner does
PureMac is a native SwiftUI utility that cleans user caches, package manager directories from pip and npm, and developer leftovers like DerivedData or simulators. It frees APFS purgeable space via tmutil. No network calls happen. All file operations remain strictly local.
The skill instructs your agent on extending the Swift codebase. You can register custom targets inside CleanCategory.swift, add scanning logic in ScannerService.swift, and wire deletions in CleanerService.swift. Automatic sweeps run on intervals from hourly to monthly.
Compiling from source demands macOS 13.0+, Swift 5.9, Xcode 15+, and xcodegen. Items over 100 MB or older than 1 year are never removed automatically.
What it helps with
- build PureMac from source using
xcodegenandxcodebuild - purge Xcode
DerivedData, simulator caches, and Homebrew data - register new scanning categories in
CleanCategory.swift - set up recurring macOS cache cleanup intervals
Example prompts for the agent
- Show me how to build PureMac from source with xcodebuild
- Help me add a Gradle cache cleaning option to CleanCategory.swift
- Configure PureMac to run an automatic clean sweep daily
How to install puremac-macos-cleaner
1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill puremac-macos-cleaner -a claude-code2Manually: put the files in place
~/.claude/skills/puremac-macos-cleaner/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/puremac-macos-cleaner/
1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill puremac-macos-cleaner -a codex2Manually: put the files in place
.agents/skills/puremac-macos-cleaner/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill puremac-macos-cleaner -a cursor2Manually: put the files in place
.cursor/skills/puremac-macos-cleaner/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install reason-machines/trending-skills puremac-macos-cleaner2Manually: put the files in place
.github/skills/puremac-macos-cleaner/SKILL.md1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill puremac-macos-cleaner -a gemini-cli2Platform CLI
gemini skills install https://github.com/reason-machines/trending-skills --path skills/puremac-macos-cleanerManually: put the files in place
.devin/skills/puremac-macos-cleaner/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill puremac-macos-cleaner -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 puremac-macos-cleaner
How do I install puremac-macos-cleaner in Claude Code?
Run npx skills add reason-machines/trending-skills --skill puremac-macos-cleaner -a claude-code. The skill will be placed in ~/.claude/skills/puremac-macos-cleaner/SKILL.md.
What does PureMac clean?
It removes system and user caches, npm and pip temp folders, Xcode derived data, simulator caches, Homebrew downloads, and purgeable APFS snapshots. It operates completely offline without tracking.
What are the prerequisites to compile PureMac?
You need macOS 13.0+, Swift 5.9, Xcode 15+, and the xcodegen tool installed via Homebrew. Project generation runs through xcodegen generate before compiling.