library

Back up libraries directories into timestamped ZIP archives, excluding video files.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires ffprobe, ruby.

What problem does it solve?

Managing raw video footage and its associated metadata across multiple projects can be chaotic. This Skill provides a structured way to organize video assets, track their analysis status, and prepare them for AI-driven editing.

Core Features & Use Cases

  • Project Initialization: Sets up a dedicated directory structure for each video project, including folders for transcripts and rough cuts.
  • Metadata Management: Creates and updates library.yaml to store video paths, durations, sizes, language, and analysis status.
  • Automated Analysis Kick-off: Automatically initiates audio transcription and visual analysis for all videos in a new library.
  • Use Case: Start a new project for "product-demo-videos" by specifying the folder containing your raw footage. The skill will organize everything and begin processing your videos in the background.

Quick Start

I want to create a new library named 'travel-vlog' and my videos are in '/Users/me/videos/travel/'. The language is English.

Frequently Asked Questions about library

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

FAQPage Schema
How do I organize and back up video project libraries with metadata?

Video library organization involves creating a structured directory with library.yaml metadata files, transcripts, and rough cuts. This Skill backs up your entire libraries directory to a timestamped ZIP file, preserving all metadata and project state while excluding video files, enabling disaster recovery and environment transfers.

What gets included when I back up a video library?

Library backups include library.yaml configuration files, transcript data, and rough cut files organized by project. Video files themselves are excluded to keep backup size manageable; only metadata and project structure are preserved for restoration or migration to another environment.

Can I restore a video library from backup to a different machine?

Yes. Backups contain the complete libraries directory structure with all metadata, transcripts, and rough cuts. Restore by extracting the ZIP to your target environment; video files must be relinked or re-imported separately since they're excluded from backups.

What are the prerequisites for backing up video libraries?

Backing up requires Ruby runtime, write access to project directories, and the backup script located at .claude/skills/backup-library/backup_libraries.rb. Your libraries directory must contain library.yaml and associated metadata files to back up.

How often should I back up my video project libraries?

Backup frequency depends on your project velocity and risk tolerance. Run backups before major edits, after completing analysis passes, or on a regular schedule for active projects. Timestamped backups let you maintain multiple recovery points without manual versioning.

Can I automate video library backups in my workflow?

Yes. The backup script integrates into automation workflows and project management pipelines. Schedule it to run before video analysis kickoffs, after metadata updates, or as part of disaster recovery procedures to maintain consistent library snapshots.