Communitygithub.com

TurkiHassan/period-launch-video

Crie um vídeo de lançamento quadrado (1440², 60fps) de 24 segundos em loop, onde toda a história acontece *dentro do ponto final do wordmark* — íris abre em uma foto noturna, UI de vidro morphs em ask → find → write → night → results → tela de bloqueio do iPhone → prova → CTA, depois fecha de volta no ponto ao lado do ícone do app. Um canvas, puro seek(t), renderização com Playwright com motion blur, SFX sincronizados com a batida, -14 LUFS. Template RTL para árabe (Geist + Thmanyah quando disponível, senão IBM Plex Sans Arabic), configurável. Use isto sempre que o usuário pedir "o vídeo night-shift", "نفس فيديو النقطة", "فيديو إطلاق مربع", "إعلان يحدث داخل النقطة", um vídeo de lançamento/promo como o do مستخرج, ou colar um brief com "inside the period of the wordmark" / painéis de vidro iOS / pílulas goo-split — mesmo que não nomeie esta skill. Também cobre a obtenção das fotos combinadas (dia/noite) (Higgsfield, Codex local image_gen, ou prompts prontos para Gemini/ChatGPT).

O que é period-launch-video?

Esta skill gera automaticamente um vídeo de lançamento de produto de 24 segundos em loop, no formato quadrado (1440x1440, 60fps), onde toda a narrativa visual ocorre dentro do ponto final do nome do produto (wordmark). É uma ferramenta poderosa para criar anúncios promocionais sofisticados, especialmente projetados para produtos com identidade visual árabe (RTL), mas adaptável para LTR também. O fluxo de trabalho é altamente automatizado e orientado por configuração: você fornece os assets do projeto (ícone, música, fotos e cópia), e a skill cuida da renderização com Playwright, motion blur, sincronização de áudio na batida e pós-edição final (LUFS, verificação de loop, etc.). A skill também gerencia a obtenção das fotos de fundo (dia/noite/amanhecer) através de Higgsfield MCP, Codex local, ou prompts para Gemini/ChatGPT. Suporta múltiplas plataformas (Claude Code, Cursor, Codex) e inclui verificação de honestidade para garantir que a história contada corresponda às funcionalidades reais do produto. O resultado é um vídeo profissional, com beat map integrado e aprovação do usuário em etapas intermediárias.

Funciona com✓Claude Code✓Codex CLI~Cursor✓Gemini CLI
npx skills add TurkiHassan/period-launch-video

Perguntar na sua IA favorita

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

Documentação

Vídeo de lançamento no ponto final

Um loop de 24 s onde todo o trabalho do produto acontece dentro do ponto final do seu wordmark. Tudo já está pronto em template/: o renderizador (index.html, todo o conteúdo em config.js), os scripts de render, scan e áudio, fontes, o ponteiro real do macOS e os SFX com pico medido. Seu trabalho é principalmente escolher conteúdo e fotos, depois executar o pipeline. Leia references/craft.md uma vez antes de alterar qualquer movimento. Ele contém a direção, o mapa de batidas e as armadilhas já resolvidas.

Fluxo de trabalho

1 · Configuração

~/.claude/skills/period-launch-video/scripts/new_project.sh <project>/brag-output/<slug>

Coloque a saída dentro do projeto do usuário. Use uma pasta ignorada pelo git, como brag-output/, se existir. O script também copia o ponteiro real do macOS deste Mac (make_pointers.py, não redistribuído) e instala o Playwright. Para combinar com o visual original, coloque os arquivos woff2 da Thmanyah Sans (thmanyah-sans-{400,500,700}.woff2) em assets/fonts/. Sem eles, a IBM Plex Sans Arabic é usada.

2 · Coletar entradas do projeto (pergunte apenas o que estiver faltando)

  • Identidade da versão publicada. Use as capturas de tela da App Store, o catálogo de assets do iOS (ícone, cores) e os dados de amostra e cópia do próprio app. Ignore assets web desatualizados. Se você não conseguir identificar qual versão está no ar, pergunte. Esta foi a principal correção desde a primeira execução.
  • Ícone: copie o ícone quadrado do app para assets/img/icon.png. O template aplica a máscara de cantos arredondados do iOS sozinho.
  • Música: use a faixa existente do projeto, se houver; caso contrário, pergunte. Execute python3 find_hit.py assets/music/song.mp3 e defina config.song.hit (≈ o hit reportado − 0.04) e bpm. enterAt (padrão 3.10) é quando o hit chega, na primeira pílula. Mantenha enterAt + 20 beats por volta de 13.5 s para que Results caia no beat 20.
  • Cópia: preencha config.js: nome (uma palavra, que se torna o wordmark preto mais o ponto final), tagline, duas linhas de abertura, a pílula ask, o job, os rótulos find/write/night, 3 resultados, notificações, 5 linhas da biblioteca, o valor do gráfico e o CTA. Mantenha todos os números consistentes entre as batidas. Dígitos ocidentais. Mantenha JSON estrito, porque audio.py o interpreta.
  • Verificação de honestidade: se a história implicar algo que o produto não faz (trabalho em lote noturno, por exemplo), avise antes de renderizar e ofereça uma redação neutra.

3 · Fotos (quatro placas)

Siga references/image-prompts.md. Escolha a rota conforme o disponível:

  1. Higgsfield MCP com créditos. Dia primeiro, depois noite e amanhecer como edições do trabalho do dia, mais externa. Verifique o custo primeiro.
  2. Codex local (which codex). scripts/codex_image.sh usa o image_gen integrado do Codex na assinatura ChatGPT do usuário.
  3. Sem créditos e sem Codex. Entregue ao usuário os quatro prompts preenchidos (Gemini para as edições) e aguarde os arquivos.

Depois:

python3 check_align.py      # noite/amanhecer devem ter deslocamento (0,0) em relação ao dia
python3 grade_plates.py     # → assets/img/*.jpg + cópias desfocadas; pré-visualização em out/plates.jpg

4 · Mapa de batidas + seis stills → aprovação antes de renderizar

node stills.mjs 1.30 7.35 10.10 14.60 17.30 23.25     # open, find, write, results, phone, out
python3 sheet.py out/review-sheet.jpg out/stills/t{1.30,7.35,10.10,14.60,17.30,23.25}.png

Examine cada still você mesmo primeiro: texto encaixado, nada cortado, vidro legível sobre a placa. Depois mostre ao usuário a folha (SendUserFile) e uma tabela do mapa de batidas construída a partir de T em index.html. Renderize apenas após a aprovação deles.

5 · Renderizar, verificar, entregar

./build.sh out/<slug>-launch.mp4     # 4 workers de render → scan.py + scan_local.py → timeline + áudio → H.264/AAC
  • scan.py deve reportar uma diferença de emenda de aproximadamente 0 (um loop limpo) e nenhum pico ou degrau.
  • Os hits de scan_local.py estão bons quando são contadores ou digitação. Qualquer outra coisa é um estalo real: descubra qual hand-off causou e corrija. Depois re-renderize apenas aqueles quadros com node render.mjs a b e re-codifique com a linha ffmpeg do build.sh.
  • Extraia um quadro no final de cada contador e confirme que mostra o número final exato.
  • Reporte as especificações (1440², 60fps, 1440 quadros, 24.0 s, LUFS, pico), quaisquer flags de honestidade abertas e o caminho do arquivo.

Adaptação além dos padrões

  • Retemporização: edite T em index.html (mantenha deslizes de 0.8 s), depois execute novamente node timeline.mjs && python3 audio.py.
  • Linhas da biblioteca são fixadas em 5 pelo layout. O eixo do gráfico tem 3 rótulos (início, meio, fim).
  • Produtos LTR (wordmark em inglês): o template está configurado como RTL. O ponto final fica na extremidade esquerda, linhas e pílulas ancoram à direita, e scans e gráficos correm da direita para a esquerda. Para LTR, espelhe essas âncoras (align, as bordas R/L, scanX, cpt) e coloque o ícone à esquerda. Reserve tempo para isso e verifique cada still.

Habilidades Relacionadas