full-transcript

Exports all dialogue from every clip in a library into a single text file.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Manually opening each clip's audio transcript to gather dialogue is tedious. This Skill consolidates every clip's spoken words from a ButterCut library into one readable text file, giving editors a complete script of their footage in a single place.

Core Features & Use Cases

  • Consolidated Dialogue Export: Runs a Ruby script that reads every clip's audio transcript in a library and writes one block per clip (filename followed by its spoken words) into full_transcript.txt.
  • Graceful Handling of Missing Dialogue: Clips without audio transcripts are skipped, and clips with transcripts but no spoken words are marked [no dialogue].
  • Use Case: A documentary editor wants to review everything said across hours of interview footage. Running this Skill produces a single full_transcript.txt in the library root that can be searched, shared, or used to plan a rough cut.

Quick Start

Ask the agent to generate a full transcript of the dialogue from a named ButterCut library, then open the resulting full_transcript.txt file it links to.

Frequently Asked Questions about full-transcript

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

FAQPage Schema
How do I get a full transcript of all clips in a ButterCut library?

Run the full-transcript skill, which executes ruby lib/buttercut/full_transcript.rb with your library name. It writes full_transcript.txt to the library root with one block per clip containing the filename and its dialogue.

What format does the exported transcript file use?

The output is a plain text file with one block per clip: the clip's filename on one line, followed by its spoken dialogue, separated by blank lines. Clips with transcripts but no speech show [no dialogue].

Does the transcript export work if a clip has no audio transcript?

Clips without an audio transcript are skipped entirely and do not appear in the output. The library's transcription step must have run first for a clip's dialogue to be included.

What dependencies are needed to run the transcript export?

The export runs as a Ruby script within the ButterCut project, so a Ruby environment matching the repository's .ruby-version is required. The underlying transcripts come from the library's WhisperX-based transcription pipeline.