菜单
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. Use when the user asks for a "contact sheet", "grid", "film strip", or wants a one-image overview of part of a clip.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
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.
A skill to automatically download and install the latest ButterCut version while preserving libraries. Use when user wants to check for updates or update their installation for new features.
The ButterCut home menu — welcome the user back, then ask what they'd like to do (start a new cut, add footage to a library, a one-off task, or something else) and hand off to the right skill. Use as the front door when the user opens ButterCut, types "buttercut" or "bc", or asks "where do I start", "what can you do", or "help me get started".
The ButterCut home menu — welcome the user back, then ask what they'd like to do (start a new cut, add footage to a library, a one-off task, or something else) and hand off to the right skill. Use as the front door when the user opens ButterCut, types "buttercut" or "bc", or asks "where do I start", "what can you do", or "help me get started".
Create a new ButterCut library. Gather library info (name, footage location, language, transcript proofreading) and scaffold the library. Use when the user wants to start a **new** library. Libraries are containers of footage and footage analysis (transcripts, contact sheets, etc). User's may also refer to Libraries as "projects" or similiar. Ask them to confirm if they want a new Library (footage container) or just a new cut (roughcut, select, etc) if unsure.
Help a user handle a one-off production related task that doesn't match perfectly to an existing skill. Examples, pull a clip's audio, extract a frame, transcribe a stray recording, draft notes, create a spreadsheet, convert a file from one type to another, etc. Use when the request doesn't map to other more obvious skills.
| name | contact-sheet |
| description | 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. Use when the user asks for a "contact sheet", "grid", "film strip", or wants a one-image overview of part of a clip. |
Builds a contact sheet from a slice of a video clip: 16 evenly spaced frames laid out in a 4x4 grid, each annotated with its hh:mm:ss timestamp.
This skill burns timestamps onto frames with ffmpeg's drawtext filter. ButterCut resolves ffmpeg from the repo's dependencies/ directory first, then PATH, and raises a clear error when it's in neither place. If a run fails with that missing-ffmpeg error, or with No such filter: 'drawtext' (some PATH builds, notably the stock Homebrew formula, omit drawtext), run the setup skill to install a suitable ffmpeg, then retry the contact sheet.
When the clip belongs to a library, always pass --library so the output lands in the standard place:
# Whole clip
ruby lib/buttercut/contact_sheet.rb <video-path> --library libraries/<lib>
# From <start> to the end of the clip
ruby lib/buttercut/contact_sheet.rb <video-path> <start> --library libraries/<lib>
# Explicit range
ruby lib/buttercut/contact_sheet.rb <video-path> <start> <end> --library libraries/<lib>
<start> and <end> accept seconds (e.g. 12.5) or HH:MM:SS / MM:SS.
Options: --library DIR, --output PATH (exact path; overrides --library).
Frame count is chosen automatically: 16 frames in a 4x4 grid for clips longer than 10 seconds, 4 frames in a 2x2 grid for clips of 10 seconds or less (avoids duplicates).
Portrait clips (iPhone, etc.) are auto-rotated using the source's container rotation metadata so timestamps land right-side-up. Variable-frame-rate sources (screen recordings, some action cams) are detected and routed through the slower seek-and-grab path automatically.
--library DIR: saved to <library>/contact_sheets/<clipname>_<descriptor>.jpg.
<descriptor> is full when covering the whole clip, otherwise HH-MM-SS_to_HH-MM-SS (dashes instead of colons).contact_sheets/DJI_20251126164651_0278_D_full.jpg, contact_sheets/DJI_20251126164651_0278_D_00-00-30_to_00-01-00.jpg.contact_sheets/ directory is created automatically if missing.--library (and no --output): saved next to the source video with the same _<descriptor> suffix. Fine for quick one-off testing, but library work should always pass --library.Share the output path as a clickable link so the user can open it directly.