Skip to content
Get packs

Mac Maintenance

Updates Homebrew, pulls clean git repos under ~/Projects, and empties the Trash on macOS.

Source Download skill
Repository
steipete/agent-scripts
Stars
7,433
Licence
MIT
Files
1 file

What it does

When asked for Mac cleanup, the agent runs a fixed routine: it updates and upgrades Homebrew packages, goes through each git repository in ~/Projects and pulls the latest changes (only fast-forward pulls, and it skips repositories with uncommitted changes unless told otherwise), and then empties the Finder Trash. It finishes with a short summary of what was upgraded, pulled, skipped, or failed.

Great for

  • Mac developers who keep many git repositories in ~/Projects and want them refreshed in one step
  • People who use Homebrew and want routine package upgrades handled by the agent
  • Users who want a repeatable, short cleanup routine instead of typing commands by hand

Skip it if

  • Users who are not on macOS or do not use Homebrew, since the commands will fail or do nothing useful
  • Anyone who wants the agent to clean up dirty repositories automatically, because the skill deliberately skips them and would need manual handling
  • Situations where emptying the Trash could be risky, since it permanently removes files the user may still want; check before running

Try asking

  • “Run my Mac maintenance routine”
  • “Update Homebrew and pull my clean repos under ~/Projects”
  • “Refresh my packages and repos, then empty the Trash”
  • “Do a Mac cleanup and report what was skipped”
Step-by-step guide: how to use Mac MaintenanceInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 1 original files, the MIT licence and an attribution note.

    mac-maintenance.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip mac-maintenance.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip mac-maintenance.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Ask the agent to list the repos it would skip before it runs, so you know which ones have uncommitted work.
  • Review the Trash contents first if you want to keep anything, because emptying it cannot be undone from the skill.
  • Expect the skill to be written for one user's setup (paths and the name Peter); adjust the wording or paths for your own machine.

What's inside

  • SKILL.md

Redistributed unmodified from steipete/agent-scripts under the MIT licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.