Agent skill

Setup

by barefootford in barefootford/buttercut

Sets up a Mac or Windows PC for ButterCut. An agent skill from barefootford/buttercut.

Custom licenceAuto-check passedMedia & Creative

Install Setup

skills CLI
$ npx skills add barefootford/buttercut --skill setup -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install barefootford/buttercut setup --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/barefootford/buttercut.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/setup .claude/skills/setup && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
setup
GitHub stars
601
Token cost
~892 tokens
SKILL.md length
388 words
Files
4
Skills in repo
15
Repo updated
First seen
Licence
Custom licence

At a glance

Sets up a Mac or Windows PC for ButterCut. An agent skill from barefootford/buttercut.

  • Works in 6 steps: Which platform is this? → Check Current State → Ask User Preference → …
  • User says install buttercut
  • SKILL.md covers Step 0: Which platform is this?, Step 1: Check Current State, Step 2: Ask User Preference and Step 3: Run Appropriate Setup, plus 2 more sections
  • Calls ruby, bundle and gem

What it does

Setup is an agent skill from barefootford/buttercut. Sets up a Mac or Windows PC for ButterCut. Installs all required dependencies (Homebrew on a Mac, Ruby, Python, FFmpeg, WhisperX). Use when user says "install buttercut", "set up my mac", "set up my pc", "get started", "first time setup", "install dependencies" or "check my installation".

Its SKILL.md is about 890 tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files (for example `advanced-setup.md`, `simple-setup.md` and `windows-setup.md`).

It sits in Media & Creative, covering Video production. It works with Python, Homebrew, FFmpeg and Ruby. The repository describes itself as: Edit Video with Claude Code.

When your agent uses it

  • User says install buttercut
  • First time setup
  • Install dependencies
  • Check my installation

Example prompts

  • “install buttercut”
  • “set up my mac”
  • “set up my pc”
  • “/setup”

Requirements

  • Python 3

Workflow steps

6 steps, taken from the step headings in SKILL.md.

  1. Which platform is this?
  2. Check Current State
  3. Ask User Preference
  4. Run Appropriate Setup
  5. Verify Installation
  6. Ask About Error Reports

What it can do on your machine

Read from SKILL.md and the folder at commit 352c1e0. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • ruby
    • bundle
    • gem
    • python3
    • ffmpeg
    • brew

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • brew.sh

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Setup loads about 892 tokens when it runs. Until then it costs about 74 tokens; SKILL.md has 388 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~74
When it runs · the whole SKILL.md, loaded when a task matches
~892

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 388 words (~892 tokens).

“Sets up a Mac or Windows PC for ButterCut. On a Mac, two installation paths are available based on user preference.”

— opening of SKILL.md by barefootford, Custom licence
name
setup

Read the full SKILL.md on GitHub

Files

SKILL.md and 3 other files in skills/setup of barefootford/buttercut.

  • SKILL.md
  • advanced-setup.md
  • simple-setup.md
  • windows-setup.md

Open the folder on GitHubat commit 352c1e0

Compare with similar skills

Setup next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Setup compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Setup this skillbarefootford/buttercut601—~892Automated safety check: PassCustom licence
Vox DirectorAlisa0808/vox-director2.2k—~5.6kAutomated safety check: PassMIT
Youtube Clipperop7418/Youtube-clipper-skill2.2k—~1.6kAutomated safety check: NotesMIT
Ffmpeg Skillkajisho5/ffmpeg-skill1.9k—~7.4kAutomated safety check: PassMIT
OpenStoryline Install HelperFireRedTeam/FireRed-OpenStoryline3.5k—~1.5kAutomated safety check: NotesApache-2.0
Cassette Video EditCassette-Editor/oh-my-cassette1571 repos~3.4kAutomated safety check: PassMIT

Similar skills

  • Vox Director

    Alisa0808/vox-director

    Turn ONE topic into a finished Vox-style paper-collage explainer / ad video, end to end on the Atlas Cloud API + local ffmpeg — script, collage keyframes, motion, voice-over, music, captions, all…

    2.2k GitHub stars~5.6k tokensUpdated 2 days ago
    Media & CreativeAuto-check passed
  • Youtube Clipper

    op7418/Youtube-clipper-skill

    YouTube 视频智能剪辑工具。下载视频和字幕,AI 分析生成精细章节(几分钟级别), 用户选择片段后自动剪辑、翻译字幕为中英双语、烧录字幕到视频,并生成总结文案。

    2.2k GitHub stars~1.6k tokensUpdated 8 mo ago
    Media & CreativeAuto-check: notes
  • Ffmpeg Skill

    kajisho5/ffmpeg-skill

    Edit video and audio with local FFmpeg from natural-language requests: cut, trim, join, resize/reframe (9:16, 1:1), speed change, captions and subtitles (SRT/ASS, animated, karaoke), logos and text…

    1.9k GitHub stars~7.4k tokensUpdated 2 days ago
    Media & CreativeAuto-check passed
  • OpenStoryline Install Helper

    FireRedTeam/FireRed-OpenStoryline

    Installs, repairs and starts a local source checkout of FireRed-OpenStoryline, from prerequisites and a venv to resources, config and the MCP and web servers.

    3.5k GitHub stars~1.5k tokensUpdated 2 mo ago
    Media & CreativeAuto-check: notes
  • Cassette Video Edit

    Cassette-Editor/oh-my-cassette

    Edit, trim, cut, caption, subtitle, reframe, combine, add background music to, or export video, audio, and image files through Cassette.

    157 GitHub starsUsed in 1 repo~3.4k tokens
    Media & CreativeAuto-check passed
  • Whiteboard Video

    gnipbao/codex-whiteboard-video-skill

    Generate smooth hand-drawn whiteboard and story videos directly inside Codex from text scripts, GPT Image 2 color storyboards, scene plans, SVGs, line art, or local images.

    323 GitHub stars~7.2k tokensUpdated 1 mo ago
    Media & CreativeAuto-check: notes

More from barefootford/buttercut

All 15 skills in this repo
  • Analyze Video

    barefootford/buttercut

    Internal sub-procedure (not a standalone entry point) — the shared footage-analysis pipeline that produces audio transcripts, contact sheets, and Sonnet-written summaries.

    601 GitHub stars~3.2k tokensUpdated 14 days ago
    Auto-check passed
  • Contact Sheet

    barefootford/buttercut

    Builds a contact sheet from a video clip — evenly spaced frames laid out in a single grid image, each with its hh:mm:ss timestamp burned in.

    601 GitHub stars~682 tokensUpdated 14 days ago
    Auto-check passed
  • Create Library

    barefootford/buttercut

    Create a new ButterCut library. An agent skill from barefootford/buttercut.

    601 GitHub stars~1.3k tokensUpdated 14 days ago
    Auto-check passed
  • Cut

    barefootford/buttercut

    Build a cut from a library — scene, selects, roughcut, custom task, or an edit from a written script.

    601 GitHub stars~2.6k tokensUpdated 14 days ago
    Auto-check passed
  • Process Library

    barefootford/buttercut

    Process the footage in a library — run analysis (transcripts, contact sheets, summaries) on a new library, resume processing on an existing one, or add and analyze new footage.

    601 GitHub stars~1.4k tokensUpdated 14 days ago
    Auto-check passed
  • Report Bug

    barefootford/buttercut

    Report a ButterCut bug to the people who build it. An agent skill from barefootford/buttercut.

    601 GitHub stars~1.2k tokensUpdated 14 days ago
    Auto-check passed

Questions about Setup

What does Setup do?

Sets up a Mac or Windows PC for ButterCut. An agent skill from barefootford/buttercut. Setup is an agent skill from barefootford/buttercut. Sets up a Mac or Windows PC for ButterCut.

When should I use Setup?

Setup fits situations like: user says install buttercut; first time setup; install dependencies; check my installation.

How do I install Setup in Claude Code?

Run `npx skills add barefootford/buttercut --skill setup -a claude-code`. Or copy the skill folder (skills/setup in barefootford/buttercut) into .claude/skills/setup in your project. Claude Code loads it when a task matches its description.

How do I install Setup in Codex?

Run `npx skills add barefootford/buttercut --skill setup -a codex`. Or copy the skill folder (skills/setup in barefootford/buttercut) into .agents/skills/setup in your project. Codex loads it when a task matches its description.

Can I use Setup in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add barefootford/buttercut --skill setup -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/setup, .gemini/skills/setup, .github/skills/setup and .opencode/skills/setup in your project.

What does Setup need to run?

Going by SKILL.md and its folder, Setup needs the command-line tools its instructions call (ruby, bundle, gem, python3, ffmpeg and brew). Our summary lists: Python 3.

Does Setup access the network?

SKILL.md names 1 domain. As links in the text: brew.sh. This is read from the text; nothing was executed.

Is Setup safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Setup use?

Setup has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Setup use?

About 892 tokens (SKILL.md is roughly 3.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Setup?

Skills that share tags, products or a category with Setup: Vox Director (Alisa0808/vox-director, 2.2k stars), Youtube Clipper (op7418/Youtube-clipper-skill, 2.2k stars), Ffmpeg Skill (kajisho5/ffmpeg-skill, 1.9k stars) and OpenStoryline Install Helper (FireRedTeam/FireRed-OpenStoryline, 3.5k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Setup?

barefootford (a GitHub user) maintains it in barefootford/buttercut, which has 601 GitHub stars. The repository holds 15 skills in this directory. The repository was last updated on September 23, 2026.

Source: barefootford/buttercut on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.