Agent skill

Mac Maintenance

by steipete in steipete/agent-scripts

Mac upkeep: brew update/upgrade, pull clean repos, empty Trash.

MITAuto-check passed

Install Mac Maintenance

skills CLI
$ npx skills add steipete/agent-scripts --skill mac-maintenance -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install steipete/agent-scripts mac-maintenance --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/steipete/agent-scripts.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/mac-maintenance .claude/skills/mac-maintenance && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
mac-maintenance
GitHub stars
7.3k
Token cost
~184 tokens
SKILL.md length
52 words
Files
1
Skills in repo
45
Repo updated
First seen
Licence
MIT

At a glance

Mac upkeep: brew update/upgrade, pull clean repos, empty Trash.

  • Works in 2 steps: Homebrew → Repos under ~/Projects
  • Calls brew, git and osascript

What it does

Mac Maintenance is an agent skill from steipete/agent-scripts. Mac upkeep: brew update/upgrade, pull clean repos, empty Trash.

Its SKILL.md is about 180 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The repository describes itself as: Scripts for agents, shared between my repositories. The licence is MIT.

Example prompts

  • “/mac-maintenance”

Workflow steps

2 steps, taken from the first numbered list in SKILL.md.

  1. Homebrew
  2. Repos under ~/Projects

What it can do on your machine

Read from SKILL.md and the folder at commit 79150cf. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • brew
    • git
    • osascript

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Mac Maintenance loads about 184 tokens when it runs. Until then it costs about 20 tokens; SKILL.md has 52 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~20
When it runs · the whole SKILL.md, loaded when a task matches
~184

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from steipete/agent-scripts at commit 79150cf, republished under its MIT licence (© steipete). 52 words, ~184 tokens.

Download SKILL.mdSave it as .claude/skills/mac-maintenance/SKILL.md (or your agent's skills folder).
name
mac-maintenance
description
Mac upkeep: brew update/upgrade, pull clean repos, empty Trash.

Mac Maintenance

Use when Peter asks for Mac cleanup, maintenance, or package/repo refresh.

Run

  1. Homebrew:
bash
brew update && brew upgrade
  1. Repos under ~/Projects:
bash
for repo in ~/Projects/*/.git; do
  dir=${repo:h}
  git -C "$dir" status --short --branch
  git -C "$dir" pull --ff-only
done

Skip dirty repos unless Peter explicitly asked to handle them. Report skipped paths.

  1. Empty Trash:
bash
osascript -e 'tell application "Finder" to empty trash'
  1. Finish with terse counts:
  • brew: upgraded / already current
  • repos: pulled / skipped / failed
  • trash: emptied / failed

© steipete, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/mac-maintenance of steipete/agent-scripts.

Open the folder on GitHubat commit 79150cf

Compare with similar skills

Mac Maintenance next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Mac Maintenance compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Mac Maintenance this skillsteipete/agent-scripts7.3k—~184Automated safety check: PassMIT
Repo Scanaffaan-m/ECC275k—~1.5kAutomated safety check: PassMIT
Repo Scanaffaan-m/ECC275k—~1.3kAutomated safety check: PassMIT
gstack Upgradegarrytan/gstack136k—~5.5kAutomated safety check: NotesMIT
Upgrade Mediabunnyremotion-dev/remotion62k—~258Automated safety check: PassCustom licence
Repo Scanaffaan-m/ECC275k1 repos~1.8kAutomated safety check: PassMIT

Similar skills

  • Repo Scan

    affaan-m/ECC

    固定されレビュー可能なコミットから外部の repo-scan スキルをインストールするブートストラップ用ポインター。クロススタックのソースコード資産監査を実行する前に repo-scan のインストールが必要な場合に使用する。この ECC ポインター自体は監査を実行しない。

    275k GitHub stars~1.5k tokensUpdated 3 days ago
    Auto-check passed
  • Repo Scan

    affaan-m/ECC

    用于从固定且可审查的提交安装外部 repo-scan 技能的引导指针。在运行跨栈源代码资产审计前需要安装 repo-scan 时使用;此 ECC 指针本身不执行审计。

    275k GitHub stars~1.3k tokensUpdated 3 days ago
    Auto-check passed
  • gstack Upgrade

    garrytan/gstack

    Upgrades an installed gstack to the latest version, handling global and vendored installs, optional auto-upgrade and snooze, and showing what is new.

    136k GitHub stars~5.5k tokensUpdated today
    Agent WorkflowsAuto-check: notes
  • Upgrade Mediabunny

    remotion-dev/remotion

    Official

    Upgrade Mediabunny and related @mediabunny packages across the Remotion repo.

    62k GitHub stars~258 tokensUpdated today
    Media & CreativeAuto-check passed
  • Repo Scan

    affaan-m/ECC

    Bootstrap pointer that installs the external repo-scan skill from a pinned, reviewable commit.

    275k GitHub starsUsed in 1 repo~1.8k tokens
    DevelopmentAuto-check passed
  • Upgrade Browser

    flutter/flutter

    Upgrade browser versions (Chrome or Firefox) in the Flutter Web Engine and/or Framework tests.

    179k GitHub stars~1.1k tokensUpdated today
    MobileAuto-check passed

More from steipete/agent-scripts

All 45 skills in this repo
  • Mac Fleet Maintenance

    steipete/agent-scripts

    Inventories and maintains a fleet of Macs from a desired-state file: package updates, repo and Xcode sync, and disk, backup and security health reports.

    7.3k GitHub stars~4.8k tokensUpdated 4 days ago
    Auto-check passed
  • Agent Transcript for PRs

    steipete/agent-scripts

    Finds a coding agent's session log, trims and redacts it, and inserts it into a GitHub PR or issue only when the user has asked for a transcript.

    7.3k GitHub starsUsed in 1 repo~698 tokens
    Auto-check passed
  • Parallels macOS VM Lab

    steipete/agent-scripts

    Uses a clean Parallels macOS VM to test GUI automation, TCC permission prompts and screenshot tools like Peekaboo, verifying results from outside the guest.

    7.3k GitHub stars~1.8k tokensUpdated 4 days ago
    Auto-check passed
  • ClawSweeper Status

    steipete/agent-scripts

    Reports ClawSweeper's status with a bundled script: workflow health, active workers, queue health and recently merged, reviewed, commented and closed items.

    7.3k GitHub stars~972 tokensUpdated 4 days ago
    Auto-check passed
  • GitHub Project Triage

    steipete/agent-scripts

    Produces maintainer-facing triage cards for a project's GitHub issues and pull requests, each with its URL, risk, test state, blockers and a next action.

    7.3k GitHub stars~4k tokensUpdated 4 days ago
    Auto-check passed
  • Nano Banana Image Generation

    steipete/agent-scripts

    Generates and edits images with Google's Nano Banana 2 (Gemini 3.1 Flash Image) through a uv script, with a draft-then-final workflow and sizes from 512 to 4K.

    7.3k GitHub stars~1.4k tokensUpdated 4 days ago
    Auto-check passed

Questions about Mac Maintenance

What does Mac Maintenance do?

Mac upkeep: brew update/upgrade, pull clean repos, empty Trash. Mac Maintenance is an agent skill from steipete/agent-scripts. Mac upkeep: brew update/upgrade, pull clean repos, empty Trash.

How do I install Mac Maintenance in Claude Code?

Run `npx skills add steipete/agent-scripts --skill mac-maintenance -a claude-code`. Or copy the skill folder (skills/mac-maintenance in steipete/agent-scripts) into .claude/skills/mac-maintenance in your project. Claude Code loads it when a task matches its description.

How do I install Mac Maintenance in Codex?

Run `npx skills add steipete/agent-scripts --skill mac-maintenance -a codex`. Or copy the skill folder (skills/mac-maintenance in steipete/agent-scripts) into .agents/skills/mac-maintenance in your project. Codex loads it when a task matches its description.

Can I use Mac Maintenance in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add steipete/agent-scripts --skill mac-maintenance -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/mac-maintenance, .gemini/skills/mac-maintenance, .github/skills/mac-maintenance and .opencode/skills/mac-maintenance in your project.

What does Mac Maintenance need to run?

Going by SKILL.md and its folder, Mac Maintenance needs the command-line tools its instructions call (brew, git and osascript).

Does Mac Maintenance access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Mac Maintenance safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Mac Maintenance use?

Mac Maintenance is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Mac Maintenance use?

About 184 tokens (SKILL.md is roughly 736 characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Mac Maintenance?

Skills that share tags, products or a category with Mac Maintenance: Repo Scan (affaan-m/ECC, 275k stars), Repo Scan (affaan-m/ECC, 275k stars), gstack Upgrade (garrytan/gstack, 136k stars) and Upgrade Mediabunny (remotion-dev/remotion, 62k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Mac Maintenance?

steipete (a GitHub user) maintains it in steipete/agent-scripts, which has 7,273 GitHub stars. The repository holds 45 skills in this directory. The repository was last updated on October 4, 2026.

Source: steipete/agent-scripts on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.