Skip to content
Get packs

Mac Fleet Maintenance

Inventory, audit and update a personal fleet of Macs against a desired software state

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

What it does

This skill teaches an AI agent to keep a small fleet of Macs in a defined state. It compares installed apps and packages against a desired inventory, audits things like SSH access, the 1Password CLI, the Octopool GitHub cache, agent CLIs, a shared global Git ignore file and Claude attribution settings, and can apply Homebrew and global package updates or fast-forward repo syncs. It is written around one owner's specific setup and paths, so it is a template for maintaining machines rather than a general tool.

Great for

  • Developers who run several Macs and want a repeatable, audited setup
  • Maintainers who already use a similar inventory file, 1Password and Tailscale-based SSH
  • Someone adapting a documented fleet playbook for their own machines

Skip it if

  • Single-machine users: most of the value is multi-host orchestration and would add risk without benefit
  • Anyone without the referenced inventory, computers.yaml and manager directories, since the skill assumes they exist and will fail or guess otherwise
  • Unattended runs on production machines: it can update packages while agents and services are running, which may disrupt software being upgraded

Try asking

  • “Audit my Macs against the full profile and tell me which required packages are missing”
  • “Run the agent CLI and Octopool audits on this machine and summarise any failures”
  • “Show me what a worker-profile Mac is missing compared with the inventory, without changing anything”
  • “Check the shared global gitignore and Claude attribution settings on this Mac”
Step-by-step guide: how to use Mac Fleet MaintenanceInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

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

    fleet-maintenance.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

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

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip fleet-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

  • Start with read-only commands such as validate, plan and the audit scripts without --repair, and review the output before any repair or update.
  • Keep the inventory and snapshots out of version control if they contain host details, and never let the agent print 1Password tokens.
  • Adapt the hard-coded paths and host names (for example mac-studio-sf) to your own setup before running anything.

What's inside

  • agents/openai.yaml
  • references/fleet-schema.md
  • scripts/admin-membership.mjs
  • scripts/agent-cli-audit.sh
  • scripts/agent-skill-links-audit.sh
  • scripts/claude-attribution-audit.sh
  • scripts/fleet-profile.mjs
  • scripts/fleet-profile.test.mjs
  • scripts/global-gitignore-audit.sh
  • scripts/host-health-audit.sh
  • scripts/octopool-audit.sh
  • scripts/op-profile-audit.sh
  • scripts/repo-sync-audit.sh
  • scripts/repo-sync-update.sh
  • 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.