Communitygithub.com

designos-beat-edit-video

Crie vídeos de marketing que vendem o aplicativo design:os studio – com filmagens reais do Studio, uma nova ideia, visual, movimento e música a cada vez. Para edições rítmicas no TikTok/Reels/Shorts e tutoriais no YouTube de 3 a 5 minutos com narração em vietnamita aprovada.

O que é designos-beat-edit-video?

Esta skill gera vídeos de marketing para o aplicativo design:os studio, produzindo conteúdo original e variado para plataformas como TikTok, Reels, Shorts e YouTube. Cada vídeo destaca uma funcionalidade real do app, com a promessa de ser visualmente único: nova ideia, nova filmagem, nova paleta de cores, novo estilo musical. O pipeline é controlado por um único arquivo JSON (spec), que define desde o conceito e a estrutura de edição até a sincronização com a batida da música (120 BPM, com âncoras de timeline que mapeiam o tempo da filmagem para o tempo do vídeo, garantindo que cliques caiam exatamente nas barras). A skill suporta geração em lote de planos criativos via `ideate.py`, validação rigorosa do spec, renderização de cenas, mixagem de áudio e verificação de qualidade. Para tutoriais longos (3–5 min), há um motor separado (`longform/`) que gera narração com TTS vietnamita (VieNeu-TTS v3 Turbo, preset "Hải Đăng"), legendas cronometradas a partir de pausas de 0,18s entre frases, e uma série de regras de respelling para pronúncia correta. A skill enfatiza que cada vídeo deve ser diferente do anterior – evitando reutilizar ideias, referências de movimento ou estilos – e que todo o material de origem deve ser filmado novamente a partir do aplicativo real, sem mockups ou takes antigos. A saída final é um vídeo 1920x1080, 30 fps, com upscale opcional para 4K, e a entrega é feita para aprovação de Jang; o upload nunca é feito pelo operador.

Funciona com~Claude Code✓Codex CLI✓Cursor
npx skills add https://github.com/NamAIEngineer/bundle-skill-video/tree/main/designos-beat-edit-video

Perguntar na sua IA favorita

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

Documentação

O que designos-beat-edit-video faz?

Propósito: marketing do aplicativo design:os studio. Cada vídeo mostra o aplicativo real fazendo algo que o espectador deseja (um recurso, uma promessa clara, uma chamada para ação). O aplicativo é o herói, não o truque de edição.

Não é um modelo fixo. Cada vídeo deve ser diferente de todos os anteriores: nova ideia, nova funcionalidade ou tarefa mostrada, nova filmagem, nova estrutura, nova paleta e fundo, nova linguagem de movimento, nova música. A criatividade precisa se destacar nos primeiros 3 segundos. Antes de planejar, leia os briefs anteriores no Projeto (orca-briefs/*designos*) e escolha opções que nenhum deles usou; escreva as escolhas no novo brief para que o próximo vídeo possa evitá-las. (engine/ideate.py, engine/music.py, references/creative-brief.md ajudam com isso.) spec/design-in-4-4.spec.json é apenas um exemplo trabalhado (sua filmagem é antiga: nunca a reutilize, sempre grave nova filmagem).

Um spec JSON comanda tudo: vídeo (render.py), áudio (audio.py), verificações (beatlib.validate, qa.py). Um novo vídeo = um novo spec + novas takes brutas. Nenhuma alteração de código.

Lote: python engine/ideate.py batch --count 30 --seed N --out batch/ gera N planos diferentes (estilo, bpm, conceito, paleta, estrutura, edições, duração, funcionalidade) além de manifest.json. Consulte references/chatgpt-instructions.md.

Regra rígida

Toda filmagem vem do aplicativo real design:os studio (Openscreen --window "design:os studio"), gravada novamente para cada vídeo. Sem mock-ups, sem outros aplicativos, sem takes antigos.

Pipeline

  1. python engine/ideate.py plan --edits N --seed <novo> --out plan.json -> conceito, estilo musical + bpm, paleta, estrutura, onde cada edição cai. Reescreva o texto você mesmo. Após a gravação: ideate.py build plan.json times.json --out spec.json. Música: 5 estilos generativos (house, lofi, trap, synthwave, cinematic), definidos em spec.music.
  2. Grave filmagem real do aplicativo (Openscreen, --window "design:os studio", cursor sobreposição editável). Regras: clique, pause cerca de 0,8 s, depois digite. Mostre o aplicativo inteiro. Cursor com aparência humana. Grave por mais tempo que a ação.
  3. Preencha o spec (spec/design-in-4-4.spec.json é o exemplo funcional; campos em references/spec-fields.md). Por edição você só precisa dos tempos brutos da filmagem: tc (cursor começa a clicar na barra lateral), hit (a tela muda), td (clique duplo no texto), ts/te (primeiro/último caractere digitado), mais T = a linha de compasso (segundos do vídeo) onde a edição cai.
  4. python engine/run.py validate spec.json - falha se uma edição estiver fora de uma linha de compasso, a digitação estiver fora da grade de 16ª, a pausa clique-texto for muito curta, ou as cenas não cobrirem a linha do tempo.
  5. python engine/run.py all spec.json --root <diretório com takes brutas> --out <diretório> -> final.mp4 (1920x1080, 30 fps, AAC) e executa qa.py. Parcial: render F N (cenas), audio, mux, qa.
  6. Olhe 3-4 quadros e a folha de contato antes de entregar. Nam posta ele mesmo; nunca poste.

Diretrizes (Marketing HQ)

GRATUITO, diga "código-fonte disponível" (nunca "código aberto"), sem "Figma killer", "Visualização do desenvolvedor", apenas funcionalidades lançadas, toda afirmação respaldada por filmagem real. O vídeo é sobre o produto, não sobre a produção.

Por que funciona

O tempo da filmagem é mapeado para o tempo do vídeo por âncoras (beatlib.Timeline.anchors), então um clique cai na linha de compasso independentemente da velocidade em que foi gravado. 120 BPM: batida 0,5 s, compasso 2 s, um caractere digitado = 0,125 s.

Verificado

A cena F re-renderizada a partir do spec é idêntica em quadros (PSNR inf) ao original; o WAV de áudio é idêntico byte a byte. O pico padrão de 0,89 deu +0,7 dBFS de pico verdadeiro na amostra; para novos vídeos defina audio.peak para cerca de 0,8.

Requisitos

python3, numpy, Pillow, ffmpeg/ffprobe; fontes macOS (HelveticaNeue.ttc, SFNSMono.ttf) ou edite fonts no spec. legacy/design-in-4-4/ mantém os scripts originais (tl.py, make8.py, audio9.py, cursor2.py) para referência.

Prompt Motion: use em todo vídeo

As ferramentas Prompt Motion Bridge (Prompt_Motion_Bridge__recommend_motion_references, search_motion_references, get_motion_reference) são a fonte de ideias de movimento. Para cada vídeo:

  • Descreva cada cena (gancho, cartões de capítulo, transições, chamadas, legendas, estatística/recapitulação, cartão final) e peça referências; pesquise com palavras-chave novas a cada vez (kinetic type, mask reveal, morph, parallax, split-screen, glitch, liquid, stagger, counter, 3D tilt, ...).
  • Escolha pelo menos 5 referências diferentes por vídeo e construa-as em código (PIL/numpy/ffmpeg ou Remotion). Anote os IDs das referências no brief e não reutilize o mesmo conjunto do vídeo anterior.
  • Brilhante, muita animação, mas a filmagem do aplicativo continua sendo a heroína e legível.

Tutorial longo (3-5 min, narração em vietnamita, YouTube)

Primeiro aprovado por Nam em 2026-11-16 (final_v3.mp4, 4:21: processo de 6 etapas a partir de um modelo .fig até telas desktop+mobile). Trate-o apenas como exemplo: o próximo vídeo longo precisa de um tópico, filmagem, estrutura e visual diferentes. Código inicial: longform/ nesta skill (também no Mac em longform/): README.md, script2.py, gen_tts.py, lib.py, build.py, audio.py. Copie para um novo espaço de trabalho e altere: capítulos, layout, design do cartão e da legenda, fundo, paleta, movimento (do Prompt Motion), estilo e andamento da música. Nunca entregue o mesmo visual duas vezes.

Ideias: cada vídeo escolhe seu próprio ângulo e formato, por exemplo, um desafio contra o tempo, antes/depois reforma, mergulho profundo em um recurso, "3 erros que iniciantes cometem", redesenhando uma tela realista, construa um mini sistema de design, mobile-first, speed-run, Q&A. Cada capítulo deve mostrar algo que o espectador deseja; um capítulo que é apenas "um erro que cometi" foi rejeitado como irrelevante. Apenas funcionalidades lançadas; verifique no aplicativo antes de prometer uma (a prévia de reprodução no canto superior direito ▷ funciona e tem ótima aparência).

Filmagem: grave novo com Openscreen para cada vídeo (modelo ou arquivo diferente, telas diferentes, edições diferentes). Openscreen grava apenas a janela do aplicativo, não diálogos nativos do macOS: mostre o seletor de arquivos como uma chamada de texto, nunca um mock-up. Selecione camadas de texto em Camadas, pressione Return, verifique se o texto está destacado e digite; digitar em um campo não focado dispara atalhos. Antes da narração afirmar uma edição, verifique o estado do aplicativo novamente (um desfazer uma vez reverteu silenciosamente o texto de um botão).

Voz (aprovada por Nam): VieNeu-TTS v3 Turbo, predefinição "Hải Đăng". Executa no Mac (.venv-voice/bin/python, gen_tts.py), 48 kHz, ~0,3x o tempo real. Não clone a voz de Jang sem sua autorização por escrito.

  • Gere frase por frase com 0,18 s de zeros exatos entre as frases; as legendas são cronometradas a partir dessas lacunas, então o texto exibido e o texto TTS devem ter o mesmo número de frases.
  • Mantenha dois textos: exibição (legendas, ortografia correta) e TTS (reescrito). Aprovado: "Design OS Studio" -> "Đi-giai Âu-ét Studio" (mantenha "Studio" em inglês), "Figma" -> "Phích-ma", ".fig" -> "phích", "megabyte" -> "mê-ga-bai". Nunca EM CAIXA ALTA "DESIGN OS" (soletrado letra por letra).
  • Nam rejeita pronúncia errada do inglês: fale vietnamita para palavras da interface (bảng lớp, vùng vẽ, bảng thuộc tính, phím xuống dòng, phím thoát, màu nền); strings de interface em inglês vão apenas em chamadas.
  • Nova reescrita: tente 5-7 variantes, verifique-as com faster-whisper (vi e en), envie a Nam uma pequena amostra WAV e só reconstrua após sua aprovação.

Regras de imagem: 1920x1080, 30 fps. O raw do Openscreen tem apenas 1600 px de largura, então mantenha o zoom da câmera em ou abaixo de ~1,6x (mais alto fica suave no YouTube). Ajuste todo o texto dentro de seu cartão (redimensionamento automático) e verifique quadros de recapitulação/estatística para transbordamento. O cartão final mostra a URL completa https://jangtrinh.github.io/design-os-studio/ grande por 8-10 s mais "Código-fonte disponível · Não afiliado ao Figma".

Entrega: exporte 1080p mais um upscale 4K (lanczos, crf 16); envie o 4K para o YouTube, apenas após ffprobe ler sua duração completa. Diga a Nam para manter o upload privado até o YouTube mostrar 2160p. Dê uma sugestão de título clara mais uma descrição com timestamps dos capítulos, o link, o crédito do modelo e "Não afiliado ao Figma". Nunca poste; Jang aprova por último.

Arquivos de referência neste pacote

  • references/openscreen.md + tools/record.sh: comando Openscreen exato, onde as takes caem, formato cursor.json, mapeamento de tela.
  • references/voice.md + longform/gen_tts.py + longform/check_voice.py: voz aprovada, instalação, tabela de reescrita, verificação Whisper.
  • references/prompt-motion.md: como usar as ferramentas Prompt Motion, referências já usadas, fallback sem o MCP.
  • references/chatgpt-instructions.md: passagem para ChatGPT/ORCA/Codex, agora com o modo de formato longo.
  • longform/: motor inicial para o vídeo longo (ROOT=<workspace> python build.py info|agenda|<chapter>, python audio.py).

Habilidades Relacionadas