Communitygithub.com

PrunaAI/pruna-skills

當有人需要從音訊中提取逐字時間戳記時使用——適用於歌詞對齊、安全剪輯邊界,或在影片編輯中燒錄字幕前的時間來源。

pruna-skills 是什麼?

這個技能的核心功能是對音訊檔案進行語音辨識與逐字時間戳記對齊,特別適用於歌詞同步、安全剪輯邊界判定,以及為影片編輯提供字幕時間資訊。它基於 WhisperX 模型,支援高精度的詞級時間對齊,並能輸出 JSON 與 SRT 格式的轉寫結果。此技能主要透過 Replicate API 運作,需要設定 `REPLICATE_API_TOKEN` 環境變數。使用者可以提供音訊檔案的 HTTPS URL,並可選地指定語言、啟用對齊輸出、提供初始提示(對饒舌或歌唱辨識有幫助)以及啟用對話者標籤。在音樂影片製作流程中,此技能通常在「對齊」階段使用,並與其他 PrunaAI 技能(如 `music-video` 和 `video-editing`)配合,形成完整的生產管線。

相容平台✓Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/PrunaAI/pruna-skills/tree/HEAD/skills/audio/whisperx

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

前置需求

在生成之前,請先安裝並載入這些技能(若已透過 @pruna 在上下文中則可跳過):

技能說明安裝指令
generation-diversity撰寫任何生成提示時使用——儀式性種子、明確結構、情境軸線,以及在付費 API 呼叫前的品質門檻。npx skills add PrunaAI/pruna-skills@generation-diversity -y
pruna-api在任何 Pruna 或 Replicate HTTP 呼叫前使用——憑證、上傳/輪詢/下載、平行批次與代理安全。npx skills add PrunaAI/pruna-skills@pruna-api -y

或者一次性安裝完整套件:npx skills add PrunaAI/pruna-skills@pruna -y

請遵循每個技能的 在生成之前 / 撰寫章節——此處不重複說明指南內容。

代理習慣

在第一個回覆中,以反引號標示 `whisperx`,確認 REPLICATE_API_TOKEN(或停止並提供 pruna-api 的註冊連結),然後詢問所需的輸入。開啟接收流程 → 在第一次 POST 前進行 generation-diversity 澄清接收。若 何時不該使用 的情境更為適合,則重新導向。

何時不該使用

請改用其他技能:

技能說明安裝指令
music-2.5當有人想要一首帶有人聲的原創 AI 歌曲時使用——包含歌詞演唱、風格提示軌,或音樂影片的來源音訊。npx skills add PrunaAI/[email protected] -y
gemini-3.1-flash-tts當有人需要口述旁白或配音時使用——解說音軌、紀錄片台詞,或與生成影片搭配的聲音。npx skills add PrunaAI/[email protected] -y
video-editing當需要對已渲染的片段進行組合或修飾時使用,使用 ffmpeg —— 連接、淡入淡出、燒錄字幕與標題、文字/標誌疊加、前後比較滑桿、背景音樂、平台匯出——或使用 Hyperframes 組合多層 HTML 合成影片。不適用於 AI 影片生成、提示技巧或基於模型的影片編輯。npx skills add PrunaAI/pruna-skills@video-editing -y

環境設定

export REPLICATE_API_TOKEN=r8_...

HTTP / 管道

偏好使用儲存庫輔助工具(它們會上傳本機音訊並寫入 JSON + SRT):

# 代理:請遵循本 SKILL.md 中的階段表 \
  --song output/my-mv/song.mp3 \
  --out output/my-mv/whisperx_transcript.json \
  --initial-prompt "前幾句歌詞有助於辨識"

# 代理:請遵循本 SKILL.md 中的階段表 \
  --cuts output/my-mv/cut_manifest.json \
  --transcript output/my-mv/whisperx_transcript.json \
  --song output/my-mv/song.mp3

在音樂影片工作流程中,請在對齊階段執行此技能——請參閱 music-video。

生成之前

  1. 依序完成前置需求指南的閱讀。
  2. 確認 audio_file(HTTPS URL——輔助工具會上傳本機檔案)、language,以及用於逐字剪輯對齊的 align_output: true。列出輸入時,請指名 REPLICATE_API_TOKEN(Replicate——而非 PRUNA_API_KEY)。
  3. 模型注意事項: 將 initial_prompt 設為第一句歌詞,以獲得更好的饒舌/歌唱辨識效果。可選的 diarization 用於多聲部對戰。

必要輸入

  • audio_file(HTTPS URL)

常見可選欄位

  • language — ISO 代碼,例如 en
  • align_output — 設定為 true 以獲得詞級時間戳記(剪輯對齊必備)
  • initial_prompt — 第一句歌詞
  • diarization — 說話者標籤

典型後續步驟

此技能之後常見的接續技能:

技能說明安裝指令
music-video當有人想要完整的音樂影片時使用——原創歌曲或人聲、表演片段、B-roll 以及歌詞同步編輯。npx skills add PrunaAI/pruna-skills@music-video -y
music-2.5當有人想要一首帶有人聲的原創 AI 歌曲時使用——包含歌詞演唱、風格提示軌,或音樂影片的來源音訊。npx skills add PrunaAI/[email protected] -y
video-editing當需要對已渲染的片段進行組合或修飾時使用,使用 ffmpeg —— 連接、淡入淡出、燒錄字幕與標題、文字/標誌疊加、前後比較滑桿、背景音樂、平台匯出——或使用 Hyperframes 組合多層 HTML 合成影片。不適用於 AI 影片生成、提示技巧或基於模型的影片編輯。npx skills add PrunaAI/pruna-skills@video-editing -y

Individual skills in this repo

This repo contains 13 individual skills — each has its own dedicated page.

PrunaAI/pruna-skills

Use when someone needs spoken narration or voiceover — explainer tracks, documentary lines, or voice to pair with generated video.

PrunaAI/pruna-skills

Use when someone wants an original AI song with vocals — sung lyrics, a style prompt track, or source audio for a music video.

PrunaAI/pruna-skills

Use before any Pruna or Replicate HTTP call — credentials, upload/poll/download, parallel batches, and agent safety.

PrunaAI/pruna-skills

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.

PrunaAI/pruna-skills

Use when crafting video or motion prompts for any generative model — dramaturgy, camera, physics-safe motion, frame anchors, and clip chaining.

PrunaAI/pruna-skills

Use when someone wants to edit an existing photo — change outfits or backgrounds, compose from reference images, or apply prompt-driven edits.

PrunaAI/pruna-skills

Use when someone explicitly wants the fastest, cheapest photo generation — mood boards, bulk panels, or quick iterations — not when controlled photoreal or in-image text is needed.

PrunaAI/pruna-skills

Use when someone wants virtual try-on — dress a person in clothes from reference photos for fashion or ecommerce.

PrunaAI/pruna-skills

Use when installing the full Pruna generative media suite — all guides, tools, and workflows in one package.

PrunaAI/pruna-skills

Use when someone wants a cinematic clip from text or start/end frames — product ads, documentary shots, or dialogue with generated audio. Not for 1080p, imported audio tracks, or talking-head-only hosts.

PrunaAI/pruna-skills

Use when someone wants a polished short clip from text, images, or imported audio — 1080p B-roll, start/end frame animation, or a motion shot with a mixed track. Not for cinematic generated-audio clips or talking-head-only hosts.

PrunaAI/pruna-skills

Use when someone wants to edit an existing video with a text instruction — recolor, restyle, remove or add objects, change environment or lighting, update on-screen text, or apply optional reference-guided product and accessory edits. Not for a new clip from scratch or ffmpeg assembly.

PrunaAI/pruna-skills

Use when someone wants a simple short clip from text or images — quick B-roll, drafts, or start/end frame animation. Not when the brief needs cinematic generation, highest quality, tight lip-sync, or imported audio at 1080p.

相關技能