IAmCosmin-YT/emotion-factory-devlog-shorts

Crie vídeos promocionais verticais para TikTok/YouTube Shorts de um jogo Roblox, do início ao fim, através de código — analise vídeos de referência, grave fly-throughs cinematográficos e gameplay real diretamente do Roblox Studio, edite um explicativo cinético com motion graphics ou um meme de reação no estilo streamer, adicione áudio livre de royalties da Pixabay e gere capas/thumbnails.

O que é emotion-factory-devlog-shorts?

Esta skill permite que você produza vídeos promocionais completos para jogos Roblox, no formato vertical (1080x1920 @60fps, H.264, -14 LUFS), incluindo capas. O workflow começa com a análise de vídeos de referência compartilhados pelo usuário, usando yt-dlp para baixar, criar folhas de quadros e transcrever, priorizando métricas de desempenho (visualizações) sobre estilos. Em seguida, você escolhe entre dois templates de edição: um explicativo com motion graphics (render_explainer.py) ou um meme de reação no estilo streamer (render_reaction.py). A gravação de cenas é feita diretamente do Roblox Studio, com comandos para capturar a viewport em 60fps, enquanto o áudio utiliza amostras reais da Pixabay com ducking automático, drop de música no momento da revelação e normalização para -14 LUFS. A skill inclui scripts utilitários (driver.py) para verificação de dependências, pré-visualização de stills, geração de folhas de contato, detecção de cortes, sincronia de legendas, mixagem de áudio e muito mais. Regras importantes protegem o usuário: proibição de clones de voz de pessoas reais, uso de samples reais em vez de sintéticos, necessidade de aprovação para downloads, não publicar informações de outros colaboradores, avisar que playtests afetam saves reais, e não gravar a área de trabalho enquanto o usuário estiver usando.

Funciona com~Claude Code~Codex CLI~Cursor

npx skills add https://github.com/IAmCosmin-YT/emotion-factory-devlog-shorts/tree/HEAD/extracted_skills/roblox-promo-shorts/roblox-promo-shorts

Documentação

Shorts promocionais Roblox

Você produz o vídeo inteiro: roteiro, filmagens, edição, áudio, capa. O trabalho do usuário é aprovar o plano, manter as mãos longe do PC durante a gravação e gravar uma narração se quiser a própria voz. A saída é 1080x1920 @60fps H.264, -14 LUFS, mais capas.

Tudo aqui foi aprendido da maneira difícil em um jogo real (Archer Heroes). Os scripts em scripts/ são o pipeline funcional; copie-os para o projeto do usuário e edite os blocos de dados claramente marcados, em vez de reescrever do zero.

Fluxo de trabalho

Analisar referências (se o usuário compartilhar links) → references/research.md. Baixe com yt-dlp, crie folhas de quadros, transcreva e obtenha as contagens de visualizações. As contagens de visualizações importam mais do que a estética: nos testes, um formato de história teve 28M de visualizações enquanto uma republicação de um momento de stream já usado teve 34K. Diga ao usuário o que realmente tem desempenho.
Escolher o formato e escrever o roteiro com fatos reais. Leia números do jogo (contagens de linhas, contagens de inimigos, taxas de drop) via Studio MCP; nunca invente estatísticas. Sinalize qualquer afirmação que o usuário precise confirmar (ex.: "Eu não escrevi uma única linha").
Gravar filmagens do Studio → references/studio-recording.md. Fly-throughs de câmera no modo de edição (câmera animada em Luau + captura de tela com ffmpeg) e gameplay real de playtest (remotes de admin, warps de ondas, modo deus). Peça ao usuário para trazer o Studio para a frente e não tocar na entrada; avise quando puder usar o PC novamente.
Editar com um dos dois modelos:
- Explicativo com motion graphics → references/explainer.md (scripts/render_explainer.py)
- Meme de reação de streamer → references/reaction.md (scripts/render_reaction.py)
Áudio → references/audio.md. Apenas amostras reais (Pixabay / biblioteca do usuário), drop de música na revelação, ducking sob a voz, loudnorm -14 LUFS.
Capas: scripts/thumbnail_explainer.py (vertical + 16:9), scripts/thumbnail_reaction.py.
Verificar, depois entregar: veja imagens estáticas e uma folha de contato, transcreva o final para verificar a sincronia das legendas, verifique o volume e envie o MP4 + capas com SendUserFile.

Caixa de ferramentas (`scripts/driver.py`)

python <skill>/scripts/driver.py check                         # ffmpeg, yt-dlp, whisper, demucs, fontes
python <skill>/scripts/driver.py stills <proj> render.py 0.5,6,12   # preview de stills -> .promo_out/stills.jpg
python <skill>/scripts/driver.py sheet  video.mp4 2            # folha de contato -> veja
python <skill>/scripts/driver.py cuts   recording.mp4          # tempos de cortes duros (PTS real)
python <skill>/scripts/driver.py words  final.mp4              # carimbos de palavras Whisper (verificação de sincronia)
python <skill>/scripts/driver.py mux    video.mp4 mix.wav out.mp4   # codificação de upload -14 LUFS
python <skill>/scripts/driver.py viewport                      # encontre a faixa de viewport do Studio na tela
python <skill>/scripts/driver.py grab   take.mp4 40 168 1146   # grave essa faixa a 60fps
python <skill>/scripts/music_drops.py track.mp3                # bpm, curva de volume, tempos de drop

Sempre abra as imagens que essas ferramentas produzem. Uma renderização que "funcionou" ainda pode estar cheia de telas RUN OVER, câmera sob o chão ou uma tag de nome que você não deve publicar.

Regras que protegem o usuário

Sem clones de voz de IA de pessoas reais. Não faça um streamer dizer falas que nunca disse, com ElevenLabs ou qualquer outra ferramenta. Use clipes reais (encontre a VOD original, não a edição de outro criador) e isole a voz com Demucs. Sugira rotular edições de meme como edições.
Sem efeitos sonoros sintetizados. O usuário achou os whooshes/cliques sintetizados com numpy desagradáveis ("unhas no quadro-negro"). Use amostras reais; graves/baixas (centroide espectral < ~2 kHz) para acertos.
Downloads precisam de um sim. Antes de baixar efeitos sonoros/música, liste arquivos, origem e tamanho aproximado, e aguarde aprovação. yt-dlp para vídeos de referência/origem é aceitável quando o usuário pediu.
Não publique informações de outras pessoas. Colaboradores do Team Create aparecem como tags de nome em capturas no modo de edição; corte ao redor ou desfoque.
Playtests escrevem no save real. Concessões/equipamentos de admin persistem. Avise e ofereça para restaurar o loadout. Restaure quaisquer edições no jogo (ShowDevelopmentGui, pastas de estágio temporárias).
Não grave a área de trabalho do usuário enquanto ele a estiver usando. Capture a tela somente depois que o usuário disser que o Studio está na frente; caso contrário, use stills de screen_capture.

Entrega

Envie o MP4 de upload e as capas com SendUserFile (exibição: render). Na mensagem: o que está nele batida por batida, o que é real vs. placeholder (ex.: voz TTS), volume e as ressalvas honestas (afirmações a verificar, risco de Content ID da música Pixabay, alterações de perfil). Ofereça uma reconstrução com um comando quando o usuário gravar a própria voz (references/explainer.md → "Substituindo pela voz do usuário").