brew-audit-workflowlisted
Install: claude install-skill nelsonlove/claude-code-plugins
The Homebrew audit workflow uses an org-mode file at `~/Desktop/BREWFILE-AUDIT.org` to triage installed Homebrew packages.
## Workflow
1. `/brew-audit` — generate or regenerate the org file from live brew state
2. User triages in Emacs — flip TODO states with `S-left`/`S-right`
3. `/brew-execute` — handles everything after triage:
- If MAYBEs remain: walk through them conversationally, explain each, update org file
- If no MAYBEs: uninstall DROPs (with dep checking), autoremove, generate clean Brewfile
4. `/brew-info <pkg>` — deep-dive on any specific package at any time
## Key design principles
- **Conversational triage beats batch annotation.** Go category by category, explain packages in context, check deps and history. Don't pre-annotate everything silently.
- **Always check actual install state.** Cross-reference `brew list` before discussing or uninstalling. Packages may already be gone.
- **Check dependencies before uninstalling.** Run `brew uses --installed <pkg>` — never remove something a KEEP package depends on.
- **Reconcile org state with reality.** On regeneration, auto-mark packages that were triaged but are no longer installed as DROP.
## File structure
The org file has three parts:
1. **Header** — org settings, TODO keywords, column view config, usage instructions
2. **Package entries** — grouped by section, each a level-2 heading with properties drawer
3. **Actions** — static org-babel elisp blocks (from `templates/actions-block.org`)
## TODO st