process-library

Orchestrates transcript, contact sheet, and summary analysis for video footage libraries.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Raw footage in a ButterCut library is unusable for AI-assisted editing until it has been analyzed. This Skill runs the full analysis pipeline — transcripts, contact sheets, and summaries — on a new or existing library, resumes interrupted processing, and analyzes newly added clips without redoing finished work.

Core Features & Use Cases

  • Full Analysis Pipeline: Coordinates the transcribe-audio → contact sheets → summaries workflow by delegating to the analyze-video skill, with idempotent steps that only process clips missing artifacts.
  • Resume and Incremental Processing: Reads the library snapshot to find incomplete clips, continues from wherever analysis left off, and processes only newly added footage via add_media.
  • Readiness Verification and Backup: Gates completion on the same ready check the cut skill uses, then automatically creates a scoped backup archive of the processed library.
  • Use Case: You return to a library after a crash mid-analysis. The Skill reads the summary, identifies the three clips missing contact sheets, finishes them, verifies readiness, and backs up the library.

Quick Start

Ask the agent to process the footage in your library, for example: "Analyze all the footage in my surf-trip library and pick up where it left off."

Frequently Asked Questions about process-library

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

FAQPage Schema
How do I analyze video footage in a ButterCut library?

Run the process-library workflow, which locates the library, reads its snapshot, and executes the transcribe-audio, contact sheet, and summary steps. Each step is idempotent and only processes clips missing an artifact, so finished clips are skipped.

How do I resume footage analysis after it was interrupted?

Point the Skill at the existing library and it reads the summary to list incomplete clips and their missing fields. It then continues from whichever analysis step is incomplete rather than restarting from scratch.

Can I add new footage to an existing library without reprocessing everything?

Yes. The add_media command appends new videos and images with empty transcript, contact sheet, and summary fields. The analysis steps only touch clips missing artifacts, so just the new clips get processed.

What dependencies does ButterCut footage analysis require?

The pipeline requires Ruby, Python, FFmpeg (full build), and WhisperX, with versions pinned in .ruby-version and .python-version. The /setup skill installs dependencies automatically, or you can follow the advanced-setup guide.

How do I force reprocessing of clips that already have transcripts?

Re-run the relevant process_footage.rb step (transcripts or contact-sheets) with the --force flag, optionally scoping it with --clips to specific files. Without --force, only clips missing an artifact are processed.