setup

Sets up a Mac for ButterCut. Installs all required dependencies (Homebrew, Ruby, Python, FFmpeg, WhisperX). Use when user says "install buttercut", "set up my mac", "get started", "first time setup", "install dependencies" or "check my installation".

⭐79stars🔀10forks📁View on GitHub🕐Updated Dec 20, 2025⬇️2downloads

When & Why to Use This Skill

This Claude skill automates the environment configuration and dependency installation for ButterCut on macOS. It streamlines the complex setup process by managing essential system tools and libraries including Homebrew, Ruby, Python, FFmpeg, and WhisperX, ensuring a consistent and functional workspace through automated verification and guided installation paths.

Use Cases

  • Initial Environment Setup: Automatically configure a new Mac with all necessary runtimes and media processing libraries required for ButterCut.
  • Dependency Audit and Repair: Use the verification script to identify missing or broken dependencies and trigger targeted re-installation.
  • Customized Installation Workflows: Provide users with a choice between a 'Simple' automated setup for non-technical users and an 'Advanced' path for developers who prefer manual version control.
  • System Readiness Check: Quickly confirm if a machine meets the technical requirements before attempting to run resource-heavy media tasks.
namesetup
descriptionSets up a Mac for ButterCut. Installs all required dependencies (Homebrew, Ruby, Python, FFmpeg, WhisperX). Use when user says "install buttercut", "set up my mac", "get started", "first time setup", "install dependencies" or "check my installation".

Skill: Mac Setup

Sets up a Mac for ButterCut. Two installation paths available based on user preference.

Step 1: Check Current State

First, run the verification script to see what's already installed:

ruby .claude/skills/setup/verify_install.rb

If all dependencies pass, inform the user they're ready to go.

Step 2: Ask User Preference

If dependencies are missing, use AskUserQuestion:

Question: "How would you like to install ButterCut?"
Header: "Install type"
Options:
  1. "Simple (recommended)" - "Fully automatic setup. We'll install everything for you using sensible defaults."
  2. "Advanced" - "For developers who want control. You manage Ruby/Python versions with your preferred tools."

Step 3: Run Appropriate Setup

Based on user choice:

  • Simple: Read and follow .claude/skills/setup/simple-setup.md
  • Advanced: Read and follow .claude/skills/setup/advanced-setup.md

Step 4: Verify Installation

After setup completes, run verification again:

ruby .claude/skills/setup/verify_install.rb

Report results to user.