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".
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.
| name | setup |
|---|---|
| description | 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". |
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.