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

Custom licenceAuto-check passedMedia & Creative

Install Cut

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

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

GitHub CLI
$ gh skill install barefootford/buttercut cut --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/cut .claude/skills/cut && 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
cut
GitHub stars
601
Token cost
~2.6k tokens
SKILL.md length
1,458 words
Files
8
Skills in repo
15
Repo updated
First seen
Licence
Custom licence

At a glance

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

  • Works in 10 steps: Confirm the library and pre-flight… → Determine Task Type → Build the Cut (produces YAML) → …
  • The user asks for a roughcut
  • SKILL.md covers 1. Confirm the library and…, 2. Determine Task Type, 3. Build the Cut (produces YAML) and 4. Verify the footage is…, plus 7 more sections
  • Calls ruby

What it does

Cut is an agent skill from barefootford/buttercut. Build a cut from a library — scene, selects, roughcut, custom task, or an edit from a written script. Starts by asking what kind of cut the user wants, then works with them to determine what they want to create. Use when the user asks for a "roughcut", "sequence", "scene", "selects", "edit from a script", or any other cut-shaped output.

Its SKILL.md is about 2.6k tokens, which your agent loads only when the skill is triggered. The skill folder holds 7 other files (for example `cut_yaml_schema.md`, `direct_path.md` and `missing_footage.md`).

It sits in Media & Creative. The repository describes itself as: Edit Video with Claude Code.

When your agent uses it

  • The user asks for a roughcut
  • Edit from a script
  • Any other cut-shaped output

Example prompts

  • “roughcut”
  • “sequence”
  • “selects”
  • “/cut”

Workflow steps

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

  1. Confirm the library and pre-flight readiness
  2. Determine Task Type
  3. Build the Cut (produces YAML)
  4. Verify the footage is reachable
  5. Determine the Editing Application
  6. Export the Cut
  7. Copy File to Desktop (if enabled)
  8. Backup Library
  9. Report Results
  10. Open in Editor (if enabled)

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

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

  • Network

    No URLs in SKILL.md.

    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

Cut loads about 2.6k tokens when it runs. Until then it costs about 86 tokens; SKILL.md has 1,458 words of instructions outside code blocks.

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

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 1,458 words (~2,644 tokens).

“This skill builds a timeline from a library.”

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

Read the full SKILL.md on GitHub

Files

SKILL.md and 7 other files in skills/cut of barefootford/buttercut.

  • SKILL.md
  • cut_yaml_schema.md
  • direct_path.md
  • missing_footage.md
  • roughcut_agent_prompt.md
  • roughcut_launch_prompt.md
  • roughcut_path.md
  • roughcut_planning.md

Open the folder on GitHubat commit 352c1e0

Compare with similar skills

Cut 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.

Cut compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Cut this skillbarefootford/buttercut601—~2.6kAutomated safety check: PassCustom licence
Guizang Social Cardsop7418/guizang-social-card-skill7.4k1 repos~7.8kAutomated safety check: PassAGPL-3.0
Weekly Changelog Videoheygen-com/hyperframes59k—~3.3kAutomated safety check: PassApache-2.0
Anthropic Brand Stylinganthropics/skills180k30 repos~559Automated safety check: PassApache-2.0
MoneyPrinterTurbo Video Generatorharry0703/MoneyPrinterTurbo129k—~2.1kAutomated safety check: WarnMIT
Brag Slim Launch Video Makerlatent-spaces/brag14k1 repos~1.9kAutomated safety check: PassMIT

Similar skills

  • Guizang Social Cards

    op7418/guizang-social-card-skill

    Produces social card sets for Xiaohongshu and WeChat: carousels, Live Photo motion cards and puzzle layouts, and WeChat cover pairs, rendered from single-file HTML.

    7.4k GitHub starsUsed in 1 repo~7.8k tokens
    Media & CreativeAuto-check passed
  • Weekly Changelog Video

    heygen-com/hyperframes

    Turns a weekly changelog markdown file into a branded HyperFrames video with voiceover, animated mock-UI scenes and captions, using fonts, background and scripts bundled in the skill.

    59k GitHub stars~3.3k tokensUpdated today
    Media & CreativeAuto-check passed
  • Anthropic Brand Styling

    anthropics/skills

    Official

    Applies Anthropic's brand colors and fonts to artifacts such as PowerPoint slides, using fixed hex values for text and accents, Poppins headings and Lora body text.

    180k GitHub starsUsed in 30 repos~559 tokens
    Media & CreativeAuto-check passed
  • MoneyPrinterTurbo Video Generator

    harry0703/MoneyPrinterTurbo

    Installs and runs MoneyPrinterTurbo to turn a topic or script into a finished short video with voice-over, subtitles, stock footage and music.

    129k GitHub stars~2.1k tokensUpdated today
    Media & CreativeAuto-check: warnings
  • Builds a short, shareable launch video with music and motion from a project directory or a website URL, using only tools already on the machine.

    14k GitHub starsUsed in 1 repo~1.9k tokens
    Media & CreativeAuto-check passed
  • HyperFrames Media Use

    heygen-com/hyperframes

    Finds, generates and edits media for HyperFrames video projects: music, sound effects, images, icons, logos, voiceovers, captions and color grades.

    59k GitHub stars~2.4k tokensUpdated today
    Media & CreativeAuto-check passed

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 16 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 16 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 16 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 16 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 16 days ago
    Auto-check passed
  • Reprocess With Contact Sheets

    barefootford/buttercut

    Reset a library's visual analysis (contact sheets, summaries, legacy visualtranscripts) and re-run the current analyze-video pipeline on it.

    601 GitHub stars~694 tokensUpdated 16 days ago
    Auto-check passed

Questions about Cut

What does Cut do?

Build a cut from a library — scene, selects, roughcut, custom task, or an edit from a written script. Cut is an agent skill from barefootford/buttercut. Build a cut from a library — scene, selects, roughcut, custom task, or an edit from a written script.

When should I use Cut?

Cut fits situations like: the user asks for a roughcut; edit from a script; any other cut-shaped output.

How do I install Cut in Claude Code?

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

How do I install Cut in Codex?

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

Can I use Cut 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 cut -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/cut, .gemini/skills/cut, .github/skills/cut and .opencode/skills/cut in your project.

What does Cut need to run?

Going by SKILL.md and its folder, Cut needs the command-line tools its instructions call (ruby).

Does Cut access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Cut 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 Cut use?

Cut 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 Cut use?

About 2.6k tokens (SKILL.md is roughly 11k 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 Cut?

Skills that share tags, products or a category with Cut: Guizang Social Cards (op7418/guizang-social-card-skill, 7.4k stars), Weekly Changelog Video (heygen-com/hyperframes, 59k stars), Anthropic Brand Styling (anthropics/skills, 180k stars) and MoneyPrinterTurbo Video Generator (harry0703/MoneyPrinterTurbo, 129k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Cut?

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.