transcribe-audio
Transcribes video audio using WhisperX, preserving original timestamps. Creates JSON transcript with word-level timing. Use when you need to generate audio transcripts for videos.
How do I install this agent skill?
npx skills add https://github.com/barefootford/buttercut --skill transcribe-audioIs this agent skill safe to install?
- Gen Agent Trust Hubwarn
The skill performs audio transcription and refinement using local Ruby scripts and WhisperX. It is susceptible to command injection via unsanitized file paths and contains an attack surface for indirect prompt injection from transcribed audio content.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
- Runlayerwarn
1/2 files flagged
- ZeroLeakspass
Score: 93/100 · 2 sections analyzed
What does this agent skill do?
Skill: Transcribe Audio (parent brief)
Note: In the library pipeline, transcription runs mechanically via
ruby lib/buttercut/process_footage.rb transcripts <library>(usingTranscribeJob), not by dispatching this sub-agent — so footage analysis comes out identical across models. The WhisperX command lives in exactly one place,lib/buttercut/transcribe_job.rb, which also runs standalone:ruby lib/buttercut/transcribe_job.rb <video_path> <output_dir> <language_code> <whisper_model>.refine_instructions.mdremains the playbook for the separate (judgment) refinement step thatanalyze-videoStep 3 dispatches.
Transcribes video audio using WhisperX and produces a clean JSON transcript with word-level timing.
SKILL.md is the parent's dispatch brief. The sub-agent's working prompt lives in agent_prompt.md — inline its contents when launching the Task agent. Don't pass SKILL.md.
Parallelism
Launch at most 2 in parallel. WhisperX is already multithreaded internally (~4 CPU threads via CTranslate2); 2 processes is the throughput-vs-RAM sweet spot on a 16GB machine.
Inputs to gather and pass inline
The parent reads library.yaml and settings.yaml and passes these values inline in each agent's prompt:
video_path— absolute path to the video filetranscript_output_dir— where to write the transcript JSON (e.g.libraries/<library>/transcripts)language_code— ISO 639-1 code (e.g.en,es) — parent maps from library.yaml'slanguagenamewhisper_model— model size from settings.yaml (e.g.small,medium,turbo)transcript_refinement— boolean from library.yaml. Iftrue, also pass:user_context(may be empty string)footage_summary(may be empty string)
After the agent returns, update library.yaml with transcript: <filename>.json.
Next step
Once all videos have audio transcripts, dispatch analyze-video for visual descriptions.
Dependencies
WhisperX must be installed. Use the setup skill to verify.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/barefootford/buttercut/transcribe-audio">View transcribe-audio on skillZs</a>