Communitygithub.com

PrunaAI/pruna-skills

누군가 보컬이 포함된 오리지널 AI 노래(가사 포함 노래, 스타일 프롬프트 트랙, 뮤직비디오용 소스 오디오)를 원할 때 사용합니다.

pruna-skills란 무엇인가요?

이 스킬은 AI 에이전트가 MiniMax의 music-2.5 모델을 통해 보컬이 있는 오리지널 노래를 생성할 수 있게 해줍니다. 사용자가 가사를 제공하고 스타일 프롬프트(장르, 분위기, 템포 등)를 선택하면, 모델이 해당 가사와 스타일에 맞춰 보컬이 포함된 노래를 만들어냅니다. Replicate API를 통해 실행되며, 반드시 REPLICATE_API_TOKEN 환경 변수가 설정되어 있어야 합니다. 이 스킬은 독립형 노래 생성뿐만 아니라, 후속 스킬인 'music-video'(뮤직비디오 제작)나 'whisperx'(가사 싱크)와 연계하여 완전한 음악 콘텐츠를 제작하는 데 사용됩니다. 내레이션이나 음성 해설이 필요한 경우 'gemini-3.1-flash-tts'를, 배경 음악만 필요한 경우 'stable-audio-2.5'를 사용하는 것이 더 적합합니다.

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

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

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

문서

전제 조건

생성 전에 다음 스킬들을 설치하고 로드하세요(@pruna로 컨텍스트에 이미 있으면 건너뜁니다):

스킬설명설치 명령어
generation-diversity생성형 프롬프트 작성 시 사용 — 유료 API 호출 전에 의식 시드, 명시적 구조, 시나리오 축, 품질 관문을 설정합니다.npx skills add PrunaAI/pruna-skills@generation-diversity -y
audio-promptingTTS, 음악, 배경 프롬프트 제작 시 사용 — 디렉터 스타일, 곡 구조, 후반 레이어링을 지정합니다.npx skills add PrunaAI/pruna-skills@audio-prompting -y
pruna-apiPruna 또는 Replicate HTTP 호출 전에 사용 — 자격 증명, 업로드/폴링/다운로드, 병렬 배치, 에이전트 안전을 보장합니다.npx skills add PrunaAI/pruna-skills@pruna-api -y

또는 전체 모음을 한 번에 설치: npx skills add PrunaAI/pruna-skills@pruna -y

각 스킬의 생성 전 / 제작 섹션을 따르세요 — 여기에 가이드 내용을 반복하지 마세요.

에이전트 습관

첫 응답에서 `music-2.5`를 백틱 안에 명시하고, REPLICATE_API_TOKEN을 확인하거나(pruna-api의 가입 링크와 함께 중단), 필요한 입력을 요청하세요. 수집 시작 → 첫 POST 전에 generation-diversity 명확화 수집을 진행하세요. 사용하지 말아야 할 경우에 해당하면 다른 스킬로 안내하세요.

사용하지 말아야 할 경우

대신 다음 스킬을 사용하세요:

스킬설명설치 명령어
gemini-3.1-flash-tts누군가 내레이션이나 음성 해설(설명 트랙, 다큐멘터리 나레이션, 영상과 짝을 이룰 음성)을 원할 때 사용합니다.npx skills add PrunaAI/[email protected] -y
stable-audio-2.5누군가 가벼운 악기 배경 음악(대화 아래의 앰비언트, 릴스나 설명 영상의 언더스코어)을 원할 때 사용합니다.npx skills add PrunaAI/[email protected] -y

환경

export REPLICATE_API_TOKEN=r8_...

뮤직비디오 워크플로우에서 오디오 슬라이싱 및 조립을 위해 ffmpeg / ffprobe 가 필요합니다.

HTTP (curl)

curl -s -X POST \
  -H "Authorization: Bearer ${REPLICATE_API_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "input": {
      "lyrics": "[Verse]\nWe built it line by line\nEvery skill a stepping stone\n\n[Chorus]\nRun the pipeline, watch it grow\nPruna models, let them flow",
      "prompt": "Indie pop, uplifting, warm female vocal, 92 BPM, acoustic guitar and mellow synth pads, no harsh distortion",
      "sample_rate": 44100,
      "bitrate": 256000,
      "audio_format": "mp3"
    }
  }' \
  "https://api.replicate.com/v1/models/minimax/music-2.5/predictions"

urls.get을 status가 succeeded가 될 때까지 폴링하고, output을 다운로드하세요.

생성 전

  1. 전제 조건 가이드 읽기 순서를 완료하세요.
  2. lyrics(구조 태그 포함)와 선택적 스타일 prompt 를 확인하세요. 필수 필드를 나열할 때는 REPLICATE_API_TOKEN(Replicate — PRUNA_API_KEY가 아님)을 명시하세요.
  3. 모델 참고 사항: 구조 태그는 각각 별도 줄에 작성하세요 — [Intro] [Verse] [Pre Chorus] [Chorus] [Hook] [Bridge] [Solo] [Inst] [Build Up] [Drop] [Interlude] [Break] [Transition] [Outro]. \n = 줄 바꿈(비디오 컷 경계로도 안전); \n\n = 일시 정지. 최대 약 5분 생성 가능. 영어와 중국어 발음이 가장 자연스럽습니다. 데이터는 Replicate를 통해 MiniMax로 전송됩니다 — 개인정보 처리방침을 참조하세요.

필수 입력

  • lyrics (문자열) — 1~3,500자

일반적인 선택적 필드

  • prompt — 장르, 분위기, 템포, 보컬 음색, 악기 (최대 약 2,000자)
  • sample_rate: 16000 · 24000 · 32000 · 44100 (기본값)
  • bitrate: 32000 · 64000 · 128000 · 256000 (기본값)
  • audio_format: mp3 (기본값) · wav · pcm

일반적인 다음 단계

이 스킬 사용 후 자주 이어지는 작업:

스킬설명설치 명령어
music-video누군가 전체 뮤직비디오(원곡 또는 보컬, 퍼포먼스 클립, B-roll, 가사 싱크 편집)를 원할 때 사용합니다.npx skills add PrunaAI/pruna-skills@music-video -y
whisperx누군가 오디오에서 단어 수준 타임스탬프(가사 정렬, 컷 안전 경계, 비디오 편집 시 자막 싱크용)가 필요할 때 사용합니다.npx skills add PrunaAI/pruna-skills@whisperx -y
p-video누군가 텍스트나 이미지로 간단한 짧은 클립(빠른 B-roll, 초안, 시작/끝 프레임 애니메이션)을 원할 때 사용합니다. 영화 같은 생성, 최고 품질, 정확한 립싱크, 1080p 가져오기 오디오가 필요할 때는 사용하지 마세요.npx skills add PrunaAI/pruna-skills@p-video -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 needs word-level timestamps from audio — lyric alignment, cut-safe line boundaries, or caption source timing before burn-in with video-editing.

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.

관련 스킬