Communitygithub.com

Product Launch Video — URL/brief → filme shot-sequence

Transforma URL de produto/marketing, script colado ou brief em vídeo de lançamento (promos SaaS, feature reveals, app launches). Arquitetura shot-sequence com blueprints cronocodificados.

O que é brief → filme shot-sequence?

Launch Video passo 1 (compose): starter-nextjs-product-launch-video. URL/script/brief → cut de lançamento.

Funciona com~Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/1345AbhishekKumar/starter-nextjs/tree/HEAD/.agents/skills/product-launch-video

Perguntar na sua IA favorita

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

Documentação

media-use: Antes de obter áudio/imagens, chame /media-use para resolver BGM/SFX/imagens do catálogo do HeyGen. Execute --adopt primeiro para registrar assets existentes. Veja /media-use skill.

Product Launch para HyperFrames

Use esta skill para capturar um produto, entender sua marca, planejar um vídeo de lançamento e construí-lo quadro a quadro no HyperFrames.

Confirme a rota antes do Passo 0. Você é o orquestrador. Execute cada passo, verifique seu portão e só então continue para o próximo passo. Esta skill é para um produto sendo comercializado, lançado, promovido ou revelado, incluindo solicitações como "promo para nosso site" quando o propósito é promocional. Roteie outras intenções para outro lugar: um tour geral de site (não lançamento) para /website-to-video; um explicador de tópico sem produto para /faceless-explainer; um PR do GitHub para /pr-to-video; legendas em filmagens existentes para /embedded-captions; um gráfico em movimento curto e sem narração para /motion-graphics. Se o usuário disser apenas "faça um vídeo" ou a rota for incerta, leia /hyperframes primeiro.

Você é o orquestrador. Trabalhe em videos/<project>/. Execute os passos em ordem e passe cada portão antes de continuar. Passos com portão do usuário são Passo 0, Passo 3 e Passo 6. Faça cada passo você mesmo, exceto o Passo 5, onde você despacha um subagente por quadro. Não coloque regras de design ou movimento aqui; elas residem no subagente do quadro, nos ../hyperframes-animation/rules/ + ../hyperframes-animation/blueprints/ e no hyperframes-creative locais desta skill.

Fluxo de trabalho: Passo 0 configuração -> hyperframes.json; Passo 1 captura -> capture/; Passo 2 sistema de design -> frame.md; Passo 3 storyboard/script -> STORYBOARD.md e SCRIPT.md; Passo 3.1 áudio -> audio_meta.json; Passo 4 design visual -> STORYBOARD.md enriquecido; Passo 5 quadros -> compositions/frames/NN-*.html e index.html; Passo 6 renderização final -> renders/video.mp4.


Passo 0: Configuração e Briefing

Objetivo: Fixar o briefing central do vídeo e criar o projeto HyperFrames, se necessário.

Inicialize apenas se hyperframes.json estiver faltando. Nomeie <project> a partir da marca ou domínio em kebab-case, como acme-promo; nunca use nome do espaço de trabalho ou timestamp.

npx hyperframes init "videos/<project>" --non-interactive --example=blank — init verifica as skills instaladas em relação às mais recentes no GitHub e atualiza o conjunto global se alguma estiver desatualizada.

Mostre o status de login antes do briefing — execute npx hyperframes auth status e repasse sua saída literalmente (não parafraseie ou reescreva). Ele informa se voz/BGM usará mecanismos HeyGen ou locais e, quando não estiver logado, como fazer login. Se não estiver logado, PARE e aguarde o usuário escolher — fazer login, ou dizer "go"/"offline" para continuar com mecanismos locais — antes de perguntar o briefing ou qualquer outra coisa. Trate como um ponto de decisão real, não uma nota passageira; não coloque a escolha na pergunta do briefing e não escreva chaves em um .env por repositório. (No modo autônomo, anote o status e continue offline.) Veja ../hyperframes-media → Preflight para a orientação canônica.

Portão: hyperframes.json existe, e ângulo, duração, proporção de aspecto e idioma estão fixos; o status de login foi mostrado (logado ou continuando offline).


Passo 1: Capturar Assets

Objetivo: Coletar o material de origem, sinais da marca e assets utilizáveis para o vídeo.

Classifique a entrada e escolha o caminho. URL explícito -> capture-o e use o site para narração e assets. Script/briefing colado -> salve literalmente como user_script.txt, pergunte uma vez "usar literalmente ou reestruturar?", armazene a resposta como VO_MODE, então resolva o alvo da captura: URL no texto -> use-o; apenas nome da marca -> WebSearch, confirme a URL em uma linha, então rastreie; sem URL/site -> caminho sem captura.

Execute a captura com: npx hyperframes capture "<URL>" -o ./capture

Se GEMINI_API_KEY, GOOGLE_API_KEY ou uma chave OpenRouter existir, a captura legenda automaticamente os assets em capture/extracted/asset-descriptions.md. Isso não é um portão de revisão. Sem uma chave de visão, use o contexto DOM e continue.

Caminho sem captura: crie capture/extracted/tokens.json, capture/extracted/visible-text.txt, capture/extracted/asset-descriptions.md e capture/assets/ manualmente. tokens.json deve ser { "title": "", "description": "", "colors": [], "fonts": [] }; preencha título/descrição do briefing quando possível. visible-text.txt contém o briefing ou script completo. asset-descriptions.md deve dizer que nenhum asset foi capturado, a menos que o usuário tenha fornecido notas de asset.

Portão: capture/extracted/tokens.json, capture/extracted/visible-text.txt, capture/extracted/asset-descriptions.md e capture/assets/ existem; você pode declarar a marca em uma frase clara. Trate asset-descriptions.md como o inventário principal de assets. Se estiver faltando após a captura real, pare e reporte a captura incompleta. Se capture/BLOCKED.md existir, siga-o.


Passo 2: Sistema de Design

Objetivo: Escolher um preset de quadro embarcado; um script transforma isso no frame.md + skin de legenda deste vídeo.

Você faz a única chamada de julgamento — qual preset. Leia ../hyperframes-creative/references/design-spec.md e escolha o preset cuja aparência melhor se adequa à marca e ao briefing. Então execute:

node <SKILL_DIR>/scripts/build-frame.mjs --preset <name> --hyperframes .

O script faz o resto deterministicamente: copia o FRAME.md do preset → frame.md e o remixa nos tokens da marca em capture/extracted/tokens.json (cores da marca mapeadas nas chaves de cor do preset por função — tinta, tela, acentos — mantendo chaves/estrutura/componentes; as fontes de exibição + corpo do preset trocadas pelas da marca), copia a skin de legenda do preset para .hyperframes/caption-skin.html e se autovalida (sai com 1 em um mapeamento quebrado). Prossiga para o próximo passo assim que sair com 0 — sem edição manual da especificação.

tokens.json sem cores/fontes da marca (por exemplo, sem captura) → o script mantém a paleta do próprio preset, um design completo e enviável. Se o briefing nomear cores/fontes da marca que a captura perdeu, adicione-as a capture/extracted/tokens.json antes de executar (ou use o design.md do usuário para preenchê-lo); só ajuste frame.md manualmente depois se um mapeamento realmente precisar.

Portão: build-frame.mjs saiu com 0 — frame.md existe a partir de um preset nomeado e (quando o preset envia um) .hyperframes/caption-skin.html existe como a fonte da skin de legenda.


Passo 3: Storyboard e Script

Objetivo: Transformar o briefing e o material capturado em um plano de história quadro a quadro aprovado.

Leia references/story-design.md, ../hyperframes-animation/blueprints-index.md, ../hyperframes-core/references/storyboard-format.md e ../hyperframes-core/references/script-format.md. Use-os para escrever STORYBOARD.md e, quando a narração for necessária, SCRIPT.md.

Use story-design.md para blueprint da história, gancho, lógica de persuasão, batidas, VO_MODE e escolhas de asset. Como um guia suave, consulte o menu de papel→blueprint em ../hyperframes-animation/blueprints-index.md: para cada batida, anote um id de blueprint candidato quando um se encaixar. A verdade da história ainda decide quais batidas existem — nunca force uma batida a se encaixar em um blueprint e nunca invente uma batida apenas porque uma forma comprovada está disponível. Escolha o asset_candidates de cada quadro visual de capture/extracted/asset-descriptions.md (o inventário canônico) — não navegue pelos capture/assets/ brutos. Não peça ao usuário para escolher assets, a menos que esse inventário esteja faltando ou seja inutilizável. Use os campos exatos exigidos das referências de storyboard e script.

Após o rascunho, mostre um resumo quadro a quadro. Nessa mesma mensagem, pergunte ao usuário duas coisas: (a) aprovar ou solicitar alterações e (b) se deseja uma prévia ao vivo do scaffold do storyboard (npx hyperframes preview) — abra-a apenas se for sim. Itere até aprovação e leve a escolha de prévia para o Passo 6.

Portão: STORYBOARD.md existe, cada quadro visual tem asset_candidates, SCRIPT.md existe quando a narração é necessária e o usuário aprovou o plano quadro a quadro.


Passo 3.1: Áudio

Objetivo: Gerar narração, tempos das palavras, música e metadados de áudio a partir do script aprovado.

Comece o áudio após a aprovação do Passo 3. Execute-o em segundo plano e continue para o Passo 4.

node <SKILL_DIR>/scripts/audio.mjs --script ./SCRIPT.md --storyboard ./STORYBOARD.md --hyperframes . --out ./audio_meta.json &

O script de áudio lida com narração, tempos das palavras, consulta de BGM da biblioteca de música do HeyGen e metadados de tempo. O mood do BGM vem do campo music: do storyboard. Isso usa a API de Áudio do HeyGen para recuperação, não geração, e usa a mesma credencial ~/.heygen que o TTS. Para detalhes do provedor, leia ../hyperframes-media/references/tts.md.

Se não houver narração e nenhum SCRIPT.md, pule a geração de voz. O BGM ainda pode ser executado se o storyboard tiver um mood musical.

Portão: o trabalho de áudio começou ou o projeto está marcado como silencioso.


Passo 4: Design Visual do Quadro

Objetivo: Adicionar a direção visual, intenção de layout e escolhas de movimento a cada quadro do storyboard.

Edite STORYBOARD.md no local. Não crie outro storyboard. Use frame.md como fonte da verdade para cor, tipo, sensação de layout e estilo.

Leia references/visual-design.md, ../hyperframes-animation/blueprints-index.md, references/motion-language.md e ../hyperframes-animation/rules-index.md. Use visual-design.md para o método (a sequência de tomadas com código de tempo, o vocabulário de Layout inline e o bloco obrigatório ## Video direction). Use ../hyperframes-animation/blueprints-index.md para escolher a forma de tomada de cada quadro. Use motion-language.md (o vocabulário de movimento + a doutrina de movimento) e ../hyperframes-animation/rules-index.md (nomes de regras válidos) para movimento — não invente nomes de movimento.

Para cada quadro visual, escreva uma sequência de tomadas com código de tempo em STORYBOARD.md de acordo com o método de visual-design.md: escolha o blueprint do quadro (ou compor), instancie-o com o conteúdo DESTE produto e ajuste o ritmo da revelação de cada Cena à narração para que o quadro se desenvolva ao longo de sua duração total em vez de carregar tudo no início e depois congelar. Declare layout e movimento inline por Cena (vocabulários em visual-design.md e motion-language.md). Adicione um bloco ## Video direction para todo o vídeo.

Não mude história, script, escolhas de asset, asset_candidates, transition_in ou material de origem capturado. Não escreva HTML neste passo.

Prepare assets nomeados depois que o design visual estiver fixo:

node <SKILL_DIR>/scripts/stage-assets.mjs --storyboard ./STORYBOARD.md --hyperframes .

Portão: todo quadro visual tem uma sequência de tomadas com código de tempo cujas revelações são ritmadas para a narração (sem carregamento frontal); ## Video direction existe; assets/ contém os assets nomeados.


Passo 5: Construir Quadros

Objetivo: Construir cada quadro do storyboard como uma composição HTML e montar o vídeo reproduzível.

Aguarde o áudio do Passo 3.1 terminar se o áudio foi iniciado. Em seguida, sincronize as durações e busque SFX; pule ambos se silencioso.

node <SKILL_DIR>/scripts/audio.mjs sync-durations --audio-meta ./audio_meta.json --storyboard ./STORYBOARD.md

node <SKILL_DIR>/scripts/audio.mjs fetch-sfx --storyboard ./STORYBOARD.md --hyperframes .

A sincronização de duração é mecânica: a duração real da voz vence; quadros silenciosos mantêm estimativas; nunca edite manualmente durações sincronizadas.

Antes do despacho, leia sub-agents/frame-worker.md e ../hyperframes-core/references/subagent-dispatch.md. Despache um subagente por quadro, em paralelo se possível; caso contrário, execute workers em ondas. Cada worker recebe exatamente um quadro.

Cada contexto de worker deve incluir PROJECT_DIR, frame_id, tamanho da tela, status da legenda e faixa de exclusão se as legendas estiverem ativadas, e RULES_DIR como o caminho absoluto para ../hyperframes-animation/rules/ desta skill. Cada worker lê frame.md, seu próprio bloco ## Frame N de STORYBOARD.md, a receita da regra local (../hyperframes-animation/rules/<id>.md) para cada movimento citado e o modelo do blueprint do quadro (../hyperframes-animation/blueprints/<id>.md). Cada worker escreve apenas compositions/frames/NN-*.html. Workers nunca devem editar STORYBOARD.md.

À medida que cada worker retorna, o orquestrador marca esse quadro como animated em STORYBOARD.md.

Depois que os tempos de áudio existirem, construa as legendas em segundo plano e monte o índice:

node <SKILL_DIR>/scripts/captions.mjs build --storyboard ./STORYBOARD.md --audio-meta ./audio_meta.json --hyperframes . --out ./caption_groups.json &

node <SKILL_DIR>/scripts/assemble-index.mjs --storyboard ./STORYBOARD.md --hyperframes .

captions.mjs usa o .hyperframes/caption-skin.html do projeto (copiado no Passo 2) como a aparência da legenda, injetando tokens da marca de frame.md; sem skin presente, ele renderiza a pílula padrão integrada. captions: skipped (<reason>) é válido. Continue sem legendas quando explicitamente puladas.

Portão: todo quadro está marcado como animated, index.html existe e as legendas estão construídas ou explicitamente puladas.


Passo 6: Finalizar

Objetivo: Verificar o vídeo montado, obter aprovação do usuário e renderizar o MP4 final.

Injetar transições, executar verificações, pausar para revisão e renderizar.

node <SKILL_DIR>/scripts/transitions.mjs inject --storyboard ./STORYBOARD.md --hyperframes .

node <SKILL_DIR>/scripts/transitions.mjs verify --storyboard ./STORYBOARD.md --index ./index.html

npx hyperframes lint

npx hyperframes validate

npx hyperframes inspect

npx hyperframes snapshot --at <frame-midpoints>

snapshot combina os quadros capturados em uma folha de contato (snapshots/contact-sheet.jpg). Dê uma olhada; se nada estiver obviamente quebrado, prossiga — não demore aqui.

Se um comando falhar, mostre stderr e pare — não acumule comandos de recuperação. Corrija você mesmo: a edição segura mais barata em compositions/frames/NN-*.html e, em seguida, execute novamente a verificação com falha.

Após as verificações passarem, pause para revisão do usuário. O vídeo está montado, visualizável e editável no Studio. Gerencie a prévia apenas uma vez entre o Passo 3 e o Passo 6: abra-a se o usuário pediu antes, ofereça-a se ele recusou antes e não pergunte novamente se ele já estiver revisando no Studio.

Prévia: npx hyperframes preview

Renderizar...

[truncado para tradução]

Individual skills in this repo

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

1345AbhishekKumar/starter-nextjs

Add captions to a talking-head video. ONE catalog (CATALOG.md) of 32 visual identities behind two engines: column-flow (captions composited INTO the scene — matte occlusion + mix-blend; cream/ink/editorial/keynote/documentary/loud/neon/glitch/chrome/velocity) and themed constitutions (anchor/ordnance/terminal/neonsign/stardust/stomp/scoreboard/transit/vhs/arcade/dossier/laser/thunder/hologram/biolume/aurora/spectrum/papercut/popup/chalkboard/graffiti/brush/inkwater/ransom/lastpage/nightcity — e.g. a glyph-decode climax, a neon sign WRITTEN stroke by stroke, or the quiet `anchor` rail default). Route by identity, never by mode. Trigger on "captions/subtitles", "embed/cinematic captions", "VFX captions", "炸/特效/酷炫字幕", a named identity, or top-tier motion-graphics asks. Embedding every word is wrong for most talking-head content — `anchor` is the verbatim default. Pipeline: transcription → hyperframes remove-background matting → HTML render → ffmpeg overlay. Requires hyperframes and a single-subject clip.

1345AbhishekKumar/starter-nextjs

The fallback workflow for authoring custom HyperFrames video compositions at any length or format — longer or multi-scene pieces, brand / sizzle reels, montages, title cards, static loops, and freeform compositions. Input- and length-agnostic. If a specialized workflow clearly fits the input — a marketed product, a website, a topic explainer, a GitHub PR, existing footage, a short motion graphic, or a Remotion port — prefer it (see /hyperframes); use this only as the general fallback when none fit.

1345AbhishekKumar/starter-nextjs

All animation knowledge for HyperFrames — atomic motion rules, multi-phase scene blueprints, scene transitions, broader motion-design techniques, AND the seven runtime adapters (GSAP default, plus Lottie, Three.js, Anime.js, CSS keyframes, Web Animations API, TypeGPU). Use for any motion or animation task: pick 2-4 rules and compose, or load a blueprint, or look up runtime-specific API (e.g. GSAP eases / Lottie player / Three.js mixer). HyperFrames-native: single paused timeline, seek-safe, deterministic.

1345AbhishekKumar/starter-nextjs

HyperFrames CLI dev loop. Use when running npx hyperframes init, add, catalog, capture, lint, validate, inspect, layout, snapshot, preview, play, render, publish, lambda, doctor, browser, info, upgrade, skills, compositions, docs, benchmark, telemetry, transcribe, tts, or remove-background, or when troubleshooting the HyperFrames build/render environment. Entry point for AWS Lambda cloud rendering (`hyperframes lambda deploy / render / progress / destroy / policies`).

1345AbhishekKumar/starter-nextjs

The HyperFrames composition contract — build one renderable project. Use for composition structure, the `data-*` timing attributes, `class="clip"`, tracks, sub-compositions, variables, framework-owned media playback, deterministic-render rules, and validation. Read before writing composition HTML.

1345AbhishekKumar/starter-nextjs

Non-animation creative direction for HyperFrames videos. Use for design spec (frame.md / design.md) handling, palettes, typography, narration, beat planning, audio-reactive visuals, composition patterns, and brand / style decisions. For atomic motion patterns and scene blueprints, use `hyperframes-animation`.

1345AbhishekKumar/starter-nextjs

Audio and media assets for HyperFrames compositions, produced by one shared audio engine (`scripts/audio.mjs`) — multi-provider TTS (HeyGen / ElevenLabs / Kokoro local), background music + sound effects (HeyGen audio-library retrieval by default, with local Lyria / MusicGen BGM generation and a bundled SFX library as the no-credential fallback), Whisper transcription, background removal, and caption authoring. Use for voiceover / TTS, BGM, SFX / sound effects, transcription, captions / subtitles / lyrics / karaoke / per-word styling, voice + provider selection, and music-mood prompting.

1345AbhishekKumar/starter-nextjs

Install and wire registry blocks and components into HyperFrames compositions. Use when running hyperframes add, installing a block or component, wiring an installed item into index.html, or working with hyperframes.json. Covers the add command, install locations, block sub-composition wiring, component snippet merging, registry discovery, and authoring a new block or component to contribute upstream (idea → scaffold → validate → PR).

1345AbhishekKumar/starter-nextjs

Use when the user wants a short, design-led motion graphic where motion is the message: kinetic typography, stat or number count-up, chart/data-viz hit, logo sting, brand lockup, lower-third, callout, social overlay, animated headline/tweet/news item, motion poster, or quick captured-page highlight. Usually under 10s and up to ~30s, with no narration arc, voice-over, or live-action subject. Can render to MP4 or transparent overlay. Not for longer, multi-scene, narrated, or brand-reel pieces (use general-video), narrated website videos (website-to-video), topic explainers (faceless-explainer), product promos (product-launch-video), PR videos (pr-to-video), or captions on existing footage (embedded-captions). When unsure whether it's a quick motion-first piece or a longer / narrated treatment, see /hyperframes.

1345AbhishekKumar/starter-nextjs

Use when the user has a music track (an audio file, or a video to pull audio from) and wants a beat-synced HyperFrames video, calm to hard-hitting. The music drives everything: one analyzer reads it once, the orchestrator lays out the frames and fills a per-frame plan, and one sub-agent builds each frame. Typography and templates are the floor — a complete video needs zero assets — but any images or videos the user supplies are cut into the frames on the same beat grid (beat-cut / ken-burns). The genre (lyric video, slideshow, kinetic promo) falls out of the per-frame choices; the pipeline never branches on it.

1345AbhishekKumar/starter-nextjs

turn a GitHub pull request (a PR URL like github.com/<owner>/<repo>/pull/<N>, an <owner>/<repo>#<N> ref, or 'this PR' in a checked-out repo) into a code-change explainer video, up to ~3 min (sweet spot 30-90s) — changelog, feature reveal, fix, or refactor walkthrough, rendered from the diff / commits / files. The input is a CODE CHANGE read via the gh CLI; there is no website capture. Use this skill for a GitHub PR. Do not use it for a product launch/promo (use /product-launch-video), a tour of a real website (use /website-to-video), a topic explainer with no PR (use /faceless-explainer), captions on existing footage (use /embedded-captions), or a short unnarrated motion graphic (use /motion-graphics). If the intent is unclear, route through /hyperframes first.

1345AbhishekKumar/starter-nextjs

Port an existing Remotion (React) composition to HyperFrames HTML. Use ONLY when the user explicitly asks to port/convert/migrate/translate a Remotion source. Do NOT use: (a) authoring a new HyperFrames composition; (b) Remotion mentioned in passing; (c) Remotion code shared as reference only; (d) "same video as my Remotion one" without explicit migrate request — treat as fresh build. Doubt → `/general-video`. One-way, Remotion-only: no reverse export (HyperFrames→Remotion or any framework), no non-Remotion source (After Effects, Framer Motion, plain React/CSS) → out of scope, re-create via `/general-video`. Flags unsupported patterns (useState, useEffect, async calculateMetadata, third-party React libs, `@remotion/lambda`) and recommends runtime interop over lossy translation. Unsure whether to port vs. build fresh, or only a passing Remotion mention? → /hyperframes.

1345AbhishekKumar/starter-nextjs

Capture a general website/URL and turn it into a HyperFrames video (site tour, showcase, or social clip from the site's own visuals). Uses headless Chrome screenshots + brand assets. Use when intent is general — portfolio/blog/landing-page showcase or social clip from the site. NOT for: product/SaaS launch or promo (→ /product-launch-video, even from a URL); topic explainer with no site (→ /faceless-explainer); GitHub PR (→ /pr-to-video); adding captions to existing video (→ /embedded-captions); short unnarrated page-highlight motion graphic (→ /motion-graphics). Unclear launch-vs-general-site? Ask one question or start at /hyperframes.

Habilidades Relacionadas