setup

Install and verify ButterCut dependencies on macOS via Simple or Advanced paths.

584|97|Updated Nov 10, 2025
One-click install
npx skills add https://github.com/barefootford/buttercut --skill setup-barefootford
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: setup
Source: https://github.com/barefootford/buttercut/tree/main/.claude/skills/setup
Command: npx skills add https://github.com/barefootford/buttercut --skill setup-barefootford

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates the Mac setup for ButterCut, reducing manual installation steps and potential errors by guiding you through dependency checks and installation.

Core Features & Use Cases

  • Automated verification: Run the verification script to check what's already installed:
ruby .claude/skills/setup/verify_install.rb
  • Two installation paths: Simple (fully automatic) and Advanced (developer-controlled).
  • Post-setup verification: Re-run the verification script to confirm a successful setup.

Quick Start

Run the initial verification to assess the current state: ruby .claude/skills/setup/verify_install.rb, then choose Simple (automatic) or Advanced and follow the corresponding guide.

Frequently Asked Questions about setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up ButterCut on my Mac automatically?

ButterCut setup on Mac is automated by running a verification script that checks installed dependencies, then choosing between Simple (fully automatic) or Advanced (developer-controlled) installation paths. The Skill installs Homebrew, Ruby, Python, FFmpeg, and WhisperX, then re-verifies success.

What dependencies does ButterCut require on macOS?

ButterCut on Mac requires Homebrew, Ruby, Python, FFmpeg, and WhisperX. The setup Skill automatically verifies what's already installed and guides you through installing missing dependencies.

Can I control which dependencies install on my Mac?

Yes. The Advanced installation path lets you control which dependencies to install, while the Simple path automates everything. Run the verification script first to see what's already present, then choose your preferred approach.

How do I verify that ButterCut dependencies installed correctly?

Run the verification script with `ruby .claude/skills/setup/verify_install.rb` before and after setup. It checks for Homebrew, Ruby, Python, FFmpeg, and WhisperX, reporting what's installed and what remains.

What's the difference between Simple and Advanced setup for ButterCut?

Simple setup fully automates dependency installation with no manual intervention. Advanced setup lets you control which dependencies install and how, giving developer-level control over the Mac environment configuration.

Do I need Homebrew already installed to set up ButterCut?

No. The ButterCut setup Skill installs Homebrew as part of the dependency chain if it's not present. The verification script checks whether it exists and the setup process handles installation.