setup_skill

Overview

This skill sets up a Mac for ButterCut by installing and verifying all required dependencies. It automates the common installation path or provides an advanced option for developers who prefer manual control. Use it to get a working ButterCut environment quickly and reliably.

How this skill works

The skill first runs a verification check to detect which dependencies are already present. If anything is missing, it asks how you want to proceed: a fully automatic, recommended install or an advanced manual path. It then executes the chosen setup routine to install Homebrew, Ruby, Python, FFmpeg, WhisperX and related tools. Finally, it re-runs verification and reports the results so you know the system is ready.

When to use it

• When you say: install buttercut, set up my mac, get started, first time setup, install dependencies, or check my installation
• Before you start using ButterCut for the first time on a Mac
• When migrating to a new Mac or reinstalling your environment
• If dependency checks fail and you need a guided fix

Best practices

• Run the verification check first to avoid reinstalling already-present components
• Choose the Simple option unless you need specific Ruby/Python versions
• On the Advanced path, manage language versions with your preferred tools (rbenv, rvm, pyenv, etc.)
• Keep your package manager (Homebrew) up to date before running installations
• Review install output for any prompts requiring user approval

Example use cases

• A new Mac user wants a single command to prepare their machine for ButterCut
• A developer prefers to control Ruby/Python versions and chooses the Advanced path
• You suspect FFmpeg or WhisperX is missing and want an automated fix
• Rebuilding a clean environment after macOS upgrade