mac-maintenance

---
name: mac-maintenance
description: "Use when working with mac upkeep: brew update/upgrade, pull clean repos, empty Trash from steipete/agent-scripts."
source: https://github.com/steipete/agent-scripts/tree/main/skills/mac-maintenance
generated: 2026-05-27T20:55:54.452Z
category: tool
audience: devops
---

## When to use

- Peter asks for Mac cleanup, maintenance, or package/repo refresh.
- Using the mac-maintenance skill's upstream workflow, guardrails, and local-tool assumptions.
- Auditing commands or operational steps before changing mac maintenance behavior.
- Needing a compact agent reference for mac upkeep: brew update/upgrade, pull clean repos, empty Trash.

## Key concepts

### Run

1. Homebrew: 2. Repos under ~/Projects: Skip dirty repos unless Peter explicitly asked to handle them. Report skipped paths. 3. Empty Trash: 4. Finish with terse counts: brew: upgraded / already current repos: pulled / skipped / failed trash: emptied / failed.

### Source-first workflow

Start from the upstream mac-maintenance instructions and local project context before inventing commands or workflows.

### Guardrails

Respect the skill's safety boundaries, especially around secrets, writes, credentials, and user-visible side effects.

## API reference

```
npx skills add steipete/agent-scripts --skill mac-maintenance
```

Install the mac-maintenance skill from steipete/agent-scripts.

```
npx skills add steipete/agent-scripts --skill mac-maintenance
```

```
brew update && brew upgrade.
```

Command or snippet documented by the upstream mac-maintenance skill.

```
brew update && brew upgrade
```

```
for repo in ~/Projects//.git; do.
```

Command or snippet documented by the upstream mac-maintenance skill.

```
for repo in ~/Projects/*/.git; do
  dir=${repo:h}
  git -C "$dir" status --short --branch
  git -C "$dir" pull --ff-only
done
```

```
osascript -e 'tell application "Finder" to empty trash'.
```

Command or snippet documented by the upstream mac-maintenance skill.

```
osascript -e 'tell application "Finder" to empty trash'
```

## Gotchas

- Read the upstream SKILL.md before use; several entries encode machine-specific paths, credentials, or local operational assumptions.

---
Generated by SkillMake from https://github.com/steipete/agent-scripts/tree/main/skills/mac-maintenance on 2026-05-27T20:55:54.452Z.
Verify against source before relying on details.

File: ~/.claude/skills/mac-maintenance/SKILL.md