misc-task

Handle one-off production tasks like extracting audio, frames, transcripts, and file conversions.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Video editors frequently need small, one-off production tasks that don't fit the core ButterCut workflows of creating libraries, processing footage, building cuts, or backups. This Skill provides a catch-all workflow for those requests while enforcing consistent rules about where output files should be saved.

Core Features & Use Cases

  • One-off media tasks: Pull a clip's audio, extract a frame, transcribe a stray recording, convert files between formats, or draft notes and spreadsheets.
  • Organized output routing: Small library-related deliverables go to libraries/<name>/misc/, small standalone files go to dated misc/<YYYY-MM-DD>/<task-name>/ folders, scratch work goes to tmp/, and large finished files go to the user's Desktop or a chosen path.
  • Unsupported feature exploration: For requests ButterCut doesn't natively support (subtitles, motion graphics), attempt custom XML or script workarounds in tmp/ without ever modifying core lib/ files, then optionally save the solution as a reusable user skill.
  • Use Case: A user asks to extract the audio from an interview clip. The Skill extracts it, saves the large audio file to the user's Desktop, and confirms the result with the user.

Quick Start

Ask the assistant to extract the audio from a clip in your library and save it to your Desktop.

Frequently Asked Questions about misc-task

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

FAQPage Schema
How do I extract audio from a video clip with ButterCut?

Ask for the audio extraction as a one-off task and the clip's audio will be pulled using the available media tools. Since audio files are large, the output is saved to your Desktop, home folder, or another path you specify rather than inside the repository.

Where does ButterCut save files from one-off tasks?

Small library-related files go to libraries/<name>/misc/, small standalone files go to dated misc/<YYYY-MM-DD>/<task-name>/ folders, and scratch work goes to tmp/. Large finished files over roughly 1 MB are saved to your Desktop or a path you choose.

Can ButterCut add subtitles or motion graphics to my video?

ButterCut does not natively support subtitles or motion graphics in its XML exports for Final Cut, Premiere, or Resolve. It can attempt a best-effort workaround by modifying XML directly with temporary scripts, but success is not guaranteed.

Will custom task scripts modify ButterCut's core files?

No. Core files in lib/ are treated as read-only because every ButterCut update restores them. Any experimental XML or script work is created in the tmp directory or the library's misc folder instead.

Can I save a successful one-off task as a reusable skill?

Yes. After a custom task succeeds, you can save the approach as a personal user skill such as user-create-subtitles so the same workflow can be repeated later. Details for doing this are documented in AGENTS.md.