reprocess-with-contact-sheets

Resets a library's visual analysis and re-runs the contact-sheet-based analyze-video pipeline.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Libraries processed under ButterCut's older pipeline contain legacy visual_transcripts instead of contact sheets and summaries, making them incompatible with the current analysis workflow. This Skill migrates those libraries onto the modern pipeline without losing audio transcripts, cuts, or plans.

Core Features & Use Cases

  • Selective Reset: Deletes contact sheets, summaries, and legacy visual transcripts while preserving audio transcripts, cuts, plans, and library metadata.
  • Safety-First Workflow: Requires explicit user confirmation and runs a full library backup before performing the destructive reset.
  • Pipeline Re-execution: Hands off to the analyze-video pipeline to regenerate contact sheets and summaries, skipping re-transcription for clips that already have audio transcripts.
  • Use Case: You have a footage library analyzed months ago under the old visual_transcript system. Run this Skill to back it up, wipe the outdated visual layer, and rebuild it with contact sheets and summaries so it works with current ButterCut features.

Quick Start

Reprocess my library named "client-shoot-march" with the contact sheet pipeline, keeping its audio transcripts and cuts.

Frequently Asked Questions about reprocess-with-contact-sheets

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

FAQPage Schema
How do I migrate a ButterCut library to the contact sheet pipeline?

Run the reprocess-with-contact-sheets skill on the library. It backs up the library, deletes legacy visual transcripts and old summaries, then re-runs the analyze-video pipeline to generate contact sheets and new summaries.

Does reprocessing a library delete my audio transcripts or cuts?

No. The reset only removes contact sheets, summaries, and legacy visual transcripts. Audio transcripts, cuts, plans, and library metadata such as footage_summary and user_context are preserved.

Will reprocessing re-transcribe the audio for every clip?

No. Clips that already have a transcript set in the snapshot skip the audio-transcription pass. Only clips missing an audio transcript get transcribed during the re-run of the analyze-video pipeline.

What happens if the backup fails before the reset?

The skill stops immediately and surfaces the error. The destructive reset is never executed without a completed backup, so the library remains untouched if the backup step fails.

When should I not use the reprocess-with-contact-sheets skill?

Avoid it for libraries already on the current contact-sheet pipeline, since there is nothing to migrate. It is intended only for libraries processed under the older visual_transcript-based system.