Communitygithub.com

PrunaAI/pruna-skills

Use quando alguém deseja uma música original com vocais — letra cantada, faixa de estilo ou áudio fonte para um videoclipe.

O que é pruna-skills?

Esta skill gera músicas originais com vocais usando o modelo MiniMax music-2.5 via Replicate. O usuário fornece letras (com marcadores estruturais como [Verso], [Refrão], etc.) e opcionalmente um prompt de estilo descrevendo gênero, humor, vocais e instrumentos. A saída é um arquivo de áudio (MP3, WAV ou PCM) com duração máxima de ~5 minutos, suporte a inglês e mandarim (melhor pronúncia). Requer REPLICATE_API_TOKEN, ffmpeg/ffprobe para edição posterior e depende das skills auxiliares `generation-diversity`, `audio-prompting` e `pruna-api` para variação de prompt, qualidade de áudio e chamadas HTTP seguras. É ideal para criadores de música que precisam de faixas cantadas para videoclipes, trilhas sonoras ou demos, mas não para narração ou música instrumental de fundo (que têm skills específicas).

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Pré-requisitos

Instale e carregue estas skills antes de gerar (pule se já estiverem em contexto via @pruna):

SkillDescriçãoInstalação
generation-diversityUse ao escrever qualquer prompt generativo — semente ritual, estrutura explícita, eixos de cenário e verificações de qualidade antes de chamadas pagas de API.npx skills add PrunaAI/pruna-skills@generation-diversity -y
audio-promptingUse ao criar prompts de TTS, música ou fundo para qualquer modelo de áudio generativo — estilo diretor, estrutura musical e camadas de pós-produção.npx skills add PrunaAI/pruna-skills@audio-prompting -y
pruna-apiUse antes de qualquer chamada HTTP ao Pruna ou Replicate — credenciais, upload/poll/download, lotes paralelos e segurança do agente.npx skills add PrunaAI/pruna-skills@pruna-api -y

Ou instale o pacote completo uma vez: npx skills add PrunaAI/pruna-skills@pruna -y

Siga as seções Antes de gerar / workshops de cada skill — não repita o conteúdo do guia aqui.

Hábito do agente

Na primeira resposta, nomeie `music-2.5` entre crases, confirme REPLICATE_API_TOKEN (ou pare com links de cadastro de pruna-api), então peça as entradas necessárias. Abra a triagem de esclarecimento → generation-diversity antes do primeiro POST. Redirecione quando Quando NÃO usar se encaixar melhor.

Quando NÃO usar

Use uma skill diferente:

SkillDescriçãoInstalação
gemini-3.1-flash-ttsUse quando alguém precisar de narração falada ou voz sobreposta — faixas explicativas, linhas documentais ou voz para emparelhar com vídeo gerado.npx skills add PrunaAI/[email protected] -y
stable-audio-2.5Use quando alguém quiser música instrumental de fundo leve — uma base ambiente sob diálogo ou trilha para reels e vídeos explicativos.npx skills add PrunaAI/[email protected] -y

Ambiente

export REPLICATE_API_TOKEN=r8_...

Requer ffmpeg / ffprobe para corte e montagem no fluxo de videoclipe.

HTTP (curl)

curl -s -X POST \
  -H "Authorization: Bearer ${REPLICATE_API_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "input": {
      "lyrics": "[Verso]\nNós construímos linha por linha\nCada skill um degrau\n\n[Refrão]\nExecute o pipeline, veja crescer\nModelos Pruna, deixe fluir",
      "prompt": "Indie pop, edificante, vocal feminino suave, 92 BPM, violão acústico e pads de sintetizador macios, sem distorção agressiva",
      "sample_rate": 44100,
      "bitrate": 256000,
      "audio_format": "mp3"
    }
  }' \
  "https://api.replicate.com/v1/models/minimax/music-2.5/predictions"

Consulte urls.get até que status seja succeeded; faça download de output.

Antes de gerar

  1. Complete a ordem de leitura do guia de Pré-requisitos.
  2. Confirme lyrics (com tags estruturais) e o opcional prompt de estilo. Ao listar campos obrigatórios, nomeie REPLICATE_API_TOKEN (Replicate — não PRUNA_API_KEY).
  3. Notas do modelo: tags estruturais em linhas próprias — [Intro] [Verse] [Pre Chorus] [Chorus] [Hook] [Bridge] [Solo] [Inst] [Build Up] [Drop] [Interlude] [Break] [Transition] [Outro]. \n = quebra de linha (também um corte seguro para vídeo); \n\n = pausa. Máximo ~5 minutos por geração. Inglês e mandarim têm pronúncia mais forte. Os dados são enviados para MiniMax via Replicate — veja sua política de privacidade.

Entrada obrigatória

  • lyrics (string) — 1 a 3.500 caracteres

Campos opcionais comuns

  • prompt — gênero, humor, andamento, timbre vocal, instrumentos (até ~2.000 caracteres)
  • sample_rate: 16000 · 24000 · 32000 · 44100 (padrão)
  • bitrate: 32000 · 64000 · 128000 · 256000 (padrão)
  • audio_format: mp3 (padrão) · wav · pcm

Próximos passos típicos

Complementos comuns após esta skill:

SkillDescriçãoInstalação
music-videoUse quando alguém quiser um videoclipe completo — música original ou vocais, clipes de performance, B-roll e edições sincronizadas com a letra.npx skills add PrunaAI/pruna-skills@music-video -y
whisperxUse quando alguém precisar de timestamps em nível de palavra do áudio — alinhamento de letra, limites de corte seguros, ou tempo de legenda antes de gravar na edição de vídeo.npx skills add PrunaAI/pruna-skills@whisperx -y
p-videoUse quando alguém quiser um clipe curto e simples a partir de texto ou imagens — B-roll rápido, rascunhos ou animação de quadro inicial/final. Não quando o briefing exigir geração cinematográfica, qualidade máxima, sincronia labial precisa ou áudio importado em 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.

Habilidades Relacionadas