Whisperx

Skill PrunaAI/pruna-skills/skills/audio/whisperx

Agent skills and plugins to give your agents access to Pruna API and generation workflows.

Install

npx -y skills add PrunaAI/pruna-skills --skill whisperx

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

12 stars12 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Use when someone needs word-level timestamps from audio — lyric alignment, cut-safe line boundaries, or caption source timing before burn-in with video-editing.

The file declares its own license as MIT. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.

SKILL.md

4.5 KB, as published. Nobody here has run it

Prerequisites

Install and load these skills before generating (skip if already in context via @pruna):

Skill	Description	Install
`generation-diversity`	Use when writing any generative prompt — ritual seed, explicit structure, scenario axes, and quality gates before paid API calls.	`npx skills add PrunaAI/pruna-skills@generation-diversity -y`
`pruna-api`	Use before any Pruna or Replicate HTTP call — credentials, upload/poll/download, parallel batches, and agent safety.	`npx skills add PrunaAI/pruna-skills@pruna-api -y`

Or install the full suite once: npx skills add PrunaAI/pruna-skills@pruna -y

Follow each skill's Before generating / craft sections — do not restate guide content here.

Agent habit

In the first reply, name `whisperx` in backticks, confirm REPLICATE_API_TOKEN (or stop with signup links from pruna-api), then ask for required inputs. Redirect when When NOT to use fits better.

When NOT to use

Use a different skill instead:

Skill	Description	Install
`music-2.5`	Use when someone wants an original AI song with vocals — sung lyrics, a style prompt track, or source audio for a music video.	`npx skills add PrunaAI/[email protected] -y`
`gemini-3.1-flash-tts`	Use when someone needs spoken narration or voiceover — explainer tracks, documentary lines, or voice to pair with generated video.	`npx skills add PrunaAI/[email protected] -y`
`video-editing`	Use when assembling or polishing already-rendered clips with ffmpeg — concat, crossfades, burned captions and subtitles, text/logo overlays, before/after sliders, background music beds, platform export — or when composing a multi-layer HTML combination video with Hyperframes. Not for AI video generation, prompt craft, or model-based video edits.	`npx skills add PrunaAI/pruna-skills@video-editing -y`

Environment

export REPLICATE_API_TOKEN=r8_...

HTTP / pipeline

Prefer the repo helpers (they upload local audio and write JSON + SRT):

# Agent: follow phase table in this SKILL.md \
  --song output/my-mv/song.mp3 \
  --out output/my-mv/whisperx_transcript.json \
  --initial-prompt "First few lyric lines help recognition"

# Agent: follow phase table in this SKILL.md \
  --cuts output/my-mv/cut_manifest.json \
  --transcript output/my-mv/whisperx_transcript.json \
  --song output/my-mv/song.mp3

In a music-video workflow, run this skill during the align phase — see music-video.

Before generating

Complete Prerequisites guide reading order.
Confirm audio_file (HTTPS URL — helpers upload local files), language, and align_output: true for word-level cut alignment. When listing inputs, name REPLICATE_API_TOKEN (Replicate — not PRUNA_API_KEY).
Model notes: set initial_prompt to the first lyric lines for better rap/sung recognition. Optional diarization for multi-voice battles.

Required input

audio_file (HTTPS URL)

Common optional fields

language — ISO code, e.g. en
align_output — true for word-level timestamps (required for cut alignment)
initial_prompt — first lyric lines
diarization — speaker labels

Typical next steps

Common follow-ons after this skill:

Skill	Description	Install
`music-video`	Use when someone wants a full music video — original song or vocals, performance clips, B-roll, and lyric-synced edits.	`npx skills add PrunaAI/pruna-skills@music-video -y`
`music-2.5`	Use when someone wants an original AI song with vocals — sung lyrics, a style prompt track, or source audio for a music video.	`npx skills add PrunaAI/[email protected] -y`
`video-editing`	Use when assembling or polishing already-rendered clips with ffmpeg — concat, crossfades, burned captions and subtitles, text/logo overlays, before/after sliders, background music beds, platform export — or when composing a multi-layer HTML combination video with Hyperframes. Not for AI video generation, prompt craft, or model-based video edits.	`npx skills add PrunaAI/pruna-skills@video-editing -y`