skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
barefootford/buttercut96 installs

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-audio
view source ↗

Is 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> (using TranscribeJob), 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.md remains the playbook for the separate (judgment) refinement step that analyze-video Step 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 file
  • transcript_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's language name
  • whisper_model — model size from settings.yaml (e.g. small, medium, turbo)
  • transcript_refinement — boolean from library.yaml. If true, 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.

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>