Communitygithub.com

SJbuilds04/vybe-audio-design

Design de som e direção musical para vídeos VYBE / HyperFrames — escolha de música por clima e arco, sincronização de efeitos sonoros com a imagem, direção de voz e escolha de provedor (HeyGen, ElevenLabs, Kokoro, Gemini), ducking, alvos de loudness, edição sincronizada com batidas e sincronia de legendas.

O que é vybe-audio-design?

Esta habilidade (skill) do VYBE Audio Design fornece diretrizes profissionais de direção de som e música para produção de vídeos curtos, como os feitos com a plataforma HyperFrames. Ela orienta o usuário (humano ou agente de IA) a decidir se há necessidade de narração, mapear a música de acordo com o arco narrativo da história (introdução, construção, clímax, resolução), escolher o ritmo (BPM) adequado, e selecionar efeitos sonoros (SFX) de forma estratégica, removendo metade para não sobrecarregar a mixagem. A skill também detalha como gerenciar vozes (narração) com provedores como HeyGen, ElevenLabs, Gemini TTS ou o Kokoro-82M offline, incluindo dicas de escrita para voz (frases curtas, 150 palavras/minuto, pausas adequadas). Além disso, oferece uma tabela de músicas por clima (orquestral cinematográfico, ambiente tecnológico, eletrônico futurista, corporativo, minimalista, energético, emocional) com orientações de consulta para recuperação de faixas (mood + instrumentação + energia + BPM). Finalmente, define alvos de mixagem precisos em LUFS (voz em -16 LUFS, música sob a voz em -28 a -31 LUFS, SFX em 0.3-0.5 volume, entrega final em -14 LUFS integrados) e regras de sincronia (SFX no quadro exato do evento, cortes nas batidas, legendas baseadas em transcrição). A skill é útil ao planejar ou corrigir o áudio de um vídeo que parece silencioso, barato, poluído ou fora de sincronia, ou ao escolher um provedor de voz ou música.

Funciona com~Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/SJbuilds04/VYBE/tree/HEAD/skills/vybe-audio-design

Perguntar na sua IA favorita

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

Documentação

VYBE Audio Design

O som é metade da qualidade percebida. Uma imagem medíocre com ótimo som parece cara; uma ótima imagem em silêncio parece inacabada.

A produção (geração, recuperação, conexão) é feita por vybe audio — veja vybe/references/audio-pipeline.md. Esta skill é a direção: o que pedir e para onde vai. Carregue references/sound-design.md para tabelas de spotting de SFX.

Decida nesta ordem

  1. É necessária narração? Sim quando o assunto precisa de explicação que a imagem não consegue transmitir (explicativos, documentários, tutoriais) ou o usuário pediu. Não para vinhetas, texto cinético, peças de humor, a maioria dos anúncios com menos de 20s. Padrão: desligado.
  2. Arco musical. Mapeie a música para a história: introdução (esparsa) → construção (camadas entrando) → pico (na revelação/clímax) → resolução (no CTA/título). Escolha o tempo a partir da edição: calmo 70–95 BPM, confiante 100–115, energético 118–128.
  3. Spotting de SFX. Marque cada evento visível que mereça peso. Depois remova metade. Deixe espaço para a música.
  4. Mixagem. Voz no topo, música abaixo, SFX entre — e atenue a música sob a voz.

Voz

ProvedorQuandoNotas
HeyGen (Starfish)melhor qualidade + timestamps nativos de palavrasprecisa de login OAuth heygen ou HEYGEN_API_KEY; franquia gratuita via heygen auth login --oauth
ElevenLabsgrande catálogo de vozes, vozes de marcaELEVENLABS_API_KEY; tempos de palavras via transcrição
Gemini TTSfala direcionada com prompts de estiloescolha explícita apenas; GEMINI_API_KEY
Kokoro-82Mgratuito, offline, privado, determinísticonpx hyperframes tts; vozes am_michael, bm_george, am_adam, af_sky, af_heart, bf_emma, af_nova; --speed 0.9–1.15

Escrevendo para voz: frases curtas, uma ideia cada, ~150 ppm (2,5 palavras/s), números escritos como falados ("vinte e nove horas"), sem texto na tela lido literalmente. Deixe 0,3s de pausa antes de cada linha e pelo menos 0,5s no final.

Música por clima

ClimaCaráterAdequado para
Orquestral cinematográficocrescendos, cordas graves, risers, impactostrailers, espaço, revelações épicas
Tecnologia ambientepads, pulsos suaves, texturas vítreasciência, IA, explicativos
Eletrônico futuristabaixo synth, arpejos, 110–125 BPMcyberpunk, lançamentos, tecnologia
Corporativo edificantepiano + bateria leve, maiornegócios, SaaS, onboarding
Minimalistapiano/pulso esparso, muito espaçoestilo Apple, luxo
Energéticobateria intensa, 120–128 BPMsocial, esportes, hype
Emocionalmenor lento → elevação maiordocumentário, histórias, causas

Formulação da consulta de recuperação: clima + instrumentação + energia + tempo, ex. "orquestra ambiente escura, construção lenta, sem vocais, 70 bpm". Nunca use faixas comerciais protegidas por direitos autorais; o fundo processual do VYBE é a alternativa offline garantida.

Alvos de mixagem

CamadaNível
Voz−16 LUFS por linha (normalizado), a camada mais alta
Música sob a voz≈ −28 a −31 LUFS efetivos (atenue para ~0,28 do fundo)
Música sozinha≈ −18 LUFS de fundo no volume 0.8
SFXvolume 0.3–0.5; impactos podem atingir pico maior por um quadro
Entrega final−14 LUFS integrado, ≤ −1 dBTP (feito por vybe finalize)

Regras de sincronia

  • SFX aterrissam no quadro do evento visual (impacto no pouso, não na decolagem; whoosh começa ~0,1s antes do movimento atingir o pico; risers terminam exatamente no impacto).
  • Corte nas batidas: npx hyperframes beats → mova os limites da cena para a grade.
  • Legendas vêm da transcrição ou timestamps do HeyGen — nunca distribuídas uniformemente.
  • Verifique com npx hyperframes audio --dir composition --at <t>.

Individual skills in this repo

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

SJbuilds04/vybe-cinematic-3d

Deterministic Three.js / WebGL for HyperFrames videos — 3D scenes, particle systems, procedural geometry, product turntables, scientific models (molecules, planets, black holes), lighting rigs, camera paths and camera cuts, rendered frame-exactly from HyperFrames time. Use when a VYBE storyboard calls for 3D, depth, particles, space, a rotating product, a data sculpture, or when a Three.js layer renders black, flickers or differs between renders.

SJbuilds04/vybe-image-to-motion

Animate a still image into video. Analyzes the image, plans the motion, and picks the right technique — programmatic 2.5D (camera moves, depth-map parallax, subject/background layer separation, particles, fog, light) or AI image-to-video (Runway Gen-4.5 / Veo 3.1 / Kling 3.0, Luma Ray 3.2, Gemini Omni Flash) for organic motion like walking, faces, water or hair — then composes the result in HyperFrames with music, SFX and text. Use when someone supplies an image and asks to animate it, bring it

SJbuilds04/vybe-motion-design

Motion design craft for VYBE / HyperFrames videos — animation principles, easing and timing, choreography and staggering, scene transitions, camera movement, and visual effects (blur, glow, masks, grain, light leaks), written as seek-safe GSAP recipes. Use when designing or fixing how things move in a video — entrances, exits, transitions between scenes, camera moves, rhythm, or when motion feels generic, floaty, stiff or repetitive.

SJbuilds04/vybe-typography

Typography for motion — type systems, font pairing with bundled OFL fonts, scale and readability rules for video, kinetic typography techniques, per-letter/word animation, captions design and safe zones, in HyperFrames compositions. Use when choosing fonts, sizing or animating text in a VYBE video, building kinetic type or lyric videos, styling captions, or when text overlaps, clips, is unreadable or looks generic.

Habilidades Relacionadas