← Back to Skills Marketplace
rogue-agent1

Brew Audit

by rogue-agent1 · GitHub ↗ · v1.0.0
cross-platform ✓ Security Clean
722
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install brew-audit
Description
Audit Homebrew installation — outdated packages, cleanup opportunities, and health checks. Use when asked about brew updates, system maintenance, or package...
README (SKILL.md)

Homebrew Audit Skill

Quickly audit your Homebrew installation for outdated packages, cleanup opportunities, and health issues.

Usage

# 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:

brew upgrade              # upgrade all outdated
brew upgrade \x3Cformula>    # upgrade specific package
brew cleanup              # remove old versions
Usage Guidance
This appears safe and coherent for macOS users with Homebrew installed. Before installing/using: (1) confirm you're on macOS and have 'brew' available, (2) review the included script (it is short and readable), (3) note that running 'brew cleanup' or 'brew upgrade' will change system state—only run those if you intend to update/remove packages, and (4) consider asking the registry owner to set the OS restriction to macOS/darwin to avoid accidental use on unsupported systems.
Capability Analysis
Type: OpenClaw Skill Name: brew-audit Version: 1.0.0 The OpenClaw skill bundle for 'brew-audit' is benign. The `SKILL.md` provides clear, non-malicious instructions for the AI agent and users. The `scripts/brew-audit.sh` script exclusively uses standard Homebrew commands (`brew outdated`, `brew cleanup --dry-run`, `brew doctor`, `brew list`, `brew --prefix`) to perform system audits. There is no evidence of data exfiltration, unauthorized network activity, persistence mechanisms, obfuscation, or prompt injection attempts against the agent. All actions are transparent and directly related to the stated purpose of auditing a Homebrew installation.
Capability Assessment
Purpose & Capability
Name and description match the included script and SKILL.md. The skill only requires the 'brew' binary which is appropriate for a Homebrew audit. Minor mismatch: SKILL.md metadata indicates macOS (darwin) but the registry lists no OS restriction—this should be reconciled but does not affect functionality.
Instruction Scope
SKILL.md and the script instruct only to run brew commands (outdated, cleanup --dry-run, doctor, list, --prefix). The script does not read arbitrary files or environment variables, nor does it post data to external endpoints. Note: Homebrew commands may contact network services as part of normal operation (e.g., checking for newer versions), which is expected behavior.
Install Mechanism
No install spec (instruction-only) and included script is plain shell. Nothing is downloaded or extracted by the skill itself. Risk is low because no external installers or URL-based payloads are used.
Credentials
No environment variables, credentials, or config paths are requested. The script does not access secrets or unrelated system config.
Persistence & Privilege
always:false (no forced inclusion). The skill is user-invocable and allows normal autonomous invocation, which is the platform default. The skill does not modify other skills or system-wide configs.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install brew-audit
  3. After installation, invoke the skill by name or use /brew-audit
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of the Homebrew Audit Skill. - Audits Homebrew installation for outdated packages, cleanup opportunities, and system health checks. - Offers full or sectional audits (outdated, cleanup, doctor). - Supports JSON output for outdated packages. - Provides usage guidance and recommended maintenance steps. - Requires Homebrew and macOS (Darwin).
Metadata
Slug brew-audit
Version 1.0.0
License
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Brew Audit?

Audit Homebrew installation — outdated packages, cleanup opportunities, and health checks. Use when asked about brew updates, system maintenance, or package... It is an AI Agent Skill for Claude Code / OpenClaw, with 722 downloads so far.

How do I install Brew Audit?

Run "/install brew-audit" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Brew Audit free?

Yes, Brew Audit is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Brew Audit support?

Brew Audit is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Brew Audit?

It is built and maintained by rogue-agent1 (@rogue-agent1); the current version is v1.0.0.

💬 Comments