setup

SKILL.md

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.

Weekly Installs
1
GitHub Stars
1.3K
First Seen
Feb 2, 2026
Installed on
opencode1
cursor1
codex1
github-copilot1
claude-code1