Communitygithub.com

PrunaAI/pruna-skills

오디오에서 단어 수준의 타임스탬프가 필요할 때 사용합니다 — 가사 정렬, 컷 세이프 라인 경계, 또는 비디오 편집 시 자막 소스 타이밍 등에 활용합니다.

pruna-skills란 무엇인가요?

이 스킬은 오디오 파일에서 단어 단위의 정밀한 타임스탬프를 추출하여 가사 정렬, 컷 편집 경계, 자막 삽입 등에 활용할 수 있도록 지원합니다. 주로 Replicate API를 통해 WhisperX 모델을 호출하며, 로컬 오디오 파일 업로드 및 JSON/SRT 출력을 지원하는 헬퍼 스크립트를 제공합니다. 음악 비디오 제작 워크플로우의 '정렬(align)' 단계에서 핵심적으로 사용되며, 초기 프롬프트(initial_prompt)를 통해 랩이나 노래 가사의 인식률을 높일 수 있습니다. 또한 화자 분리(diarization) 옵션을 제공하여 여러 화자가 등장하는 오디오에서도 정확한 타임스탬프를 얻을 수 있습니다.

지원 대상✓Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/PrunaAI/pruna-skills/tree/HEAD/skills/audio/whisperx

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

사전 요구 사항

이 스킬을 생성하기 전에 다음 스킬들을 설치하고 로드하세요 (이미 @pruna를 통해 컨텍스트에 있으면 건너뛰어도 됩니다):

스킬설명설치
generation-diversity유료 API 호출 전에 시드 루틴, 명시적 구조, 시나리오 축, 품질 게이트 등 생성 프롬프트를 작성할 때 사용합니다.npx skills add PrunaAI/pruna-skills@generation-diversity -y
pruna-apiPruna 또는 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 전에 인테이크(intake) → 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

뮤직 비디오 워크플로우에서 이 스킬은 정렬(align) 단계 중에 실행하세요 — 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.

관련 스킬