create-library

Creates a new ButterCut library by gathering footage info and scaffolding the library directory structure.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Setting up a new video editing project in ButterCut requires collecting footage details, configuring transcription settings, and scaffolding a structured library directory. This Skill guides the agent through that setup conversationally and creates the library in one validated flow.

Core Features & Use Cases

  • Guided Library Setup: Asks the user one question at a time for library name, footage location, spoken language, and transcript proofreading preference.
  • Footage Validation: Verifies video (mov, mp4, mts, m2ts, mxf, avi) and image (jpg, jpeg, png) files exist before creation and guards against overwriting an existing library.
  • Editor & Transcription Defaults: Initializes settings.yaml with the user's NLE (Final Cut Pro, Premiere, DaVinci Resolve) and Whisper model choice.
  • Use Case: A user drops a folder of interview clips into chat and says "start a new project" — the Skill normalizes the name, creates the library with transcripts/, contact_sheets/, cuts/ directories, then hands off to footage analysis.

Quick Start

Ask the agent to create a new ButterCut library for your footage folder and answer its setup questions about name, language, and transcript proofreading.

Frequently Asked Questions about create-library

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

FAQPage Schema
How do I create a new ButterCut library for my video footage?

Invoke the create-library skill and answer its questions one at a time: library name, footage file locations, spoken language, and transcript proofreading preference. It then runs Library.create to scaffold the directory tree and write library.yaml.

What video and image formats does a ButterCut library support?

Supported video formats are mov, mp4, mts, m2ts, mxf, and avi; supported image formats are jpg, jpeg, and png. Other file types are rejected with a message and can be converted first using ffmpeg.

Which video editors work with ButterCut libraries?

ButterCut supports Final Cut Pro X (fcpx), Adobe Premiere Pro (premiere), and DaVinci Resolve (resolve). The editor shortcode is saved to libraries/settings.yaml during initial setup and passed into the library creation call.

What happens if a library with the same name already exists?

The skill checks with library.rb exists before creating anything. If the name is taken, it stops and switches to the process-library skill instead, since the user is resuming or adding footage to an existing library.

What is transcript refinement in ButterCut library setup?

Transcript refinement is a boolean option where Claude proofreads generated transcripts using the video's context to fix mistakes. It defaults to true and is saved as transcript_refinement in library.yaml.