brew-audit
Audit Homebrew installation — outdated packages, cleanup opportunities, and health checks.
Setup & Installation
Install command
clawhub install rogue-agent1/brew-auditIf the CLI is not installed:
Install command
npx clawhub@latest install rogue-agent1/brew-auditOr install with OpenClaw CLI:
Install command
openclaw skills install rogue-agent1/brew-auditor paste the repo link into your assistant's chat
Install command
https://github.com/openclaw/skills/tree/main/skills/rogue-agent1/brew-auditWhat This Skill Does
Audits a Homebrew installation on macOS for outdated packages, unused downloads, and configuration issues. Runs a single script combining brew outdated, cleanup dry-run, and brew doctor checks. Outputs a summary of total formulae and cask counts.
Combines outdated listing, cleanup estimates, and brew doctor diagnostics into one command instead of running three separate brew commands and interpreting their output manually.
When to Use It
- Finding which packages need updates before a macOS upgrade
- Estimating disk space recoverable from old Homebrew downloads
- Diagnosing broken symlinks or permission errors after a system update
- Checking cask versions after returning to a development machine
- Running a monthly maintenance check on installed formulae and casks
View original SKILL.md file
# Homebrew Audit Skill Quickly audit your Homebrew installation for outdated packages, cleanup opportunities, and health issues. ## Usage ```bash # Full audit (outdated + cleanup + doctor + summary) bash scripts/brew-audit.sh # Specific sections bash scripts/brew-audit.sh --section outdated bash scripts/brew-audit.sh --section cleanup bash scripts/brew-audit.sh --section doctor # JSON output (outdated only) bash scripts/brew-audit.sh --json --section outdated ``` ## What It Checks ### 📦 Outdated Packages Lists all formulae and casks with newer versions available, with current → available version info. ### 🧹 Cleanup Opportunities Shows how many old versions/downloads can be removed and estimated disk savings. Run `brew cleanup` to reclaim. ### 🩺 Health Check Runs `brew doctor` to detect: - Formulae with no source (orphaned kegs) - Deprecated/disabled packages needing replacement - Permission issues, broken symlinks, config problems ### 📊 Summary Total formulae, casks, and Homebrew prefix. ## When to Use - Periodic system maintenance (weekly/monthly) - Before major upgrades - When disk space is low - After noticing build failures (doctor check) ## Updating Packages After reviewing the audit: ```bash brew upgrade # upgrade all outdated brew upgrade <formula> # upgrade specific package brew cleanup # remove old versions ```
Example Workflow
Here's how your AI assistant might use this skill in practice.
User asks: Finding which packages need updates before a macOS upgrade
- 1Finding which packages need updates before a macOS upgrade
- 2Estimating disk space recoverable from old Homebrew downloads
- 3Diagnosing broken symlinks or permission errors after a system update
- 4Checking cask versions after returning to a development machine
- 5Running a monthly maintenance check on installed formulae and casks
Audit Homebrew installation — outdated packages, cleanup opportunities, and health checks.
Security Audits
These signals reflect official OpenClaw status values. A Suspicious status means the skill should be used with extra caution.