Communitygithub.com

Lançamento de Produto para HyperFrames

Transforme uma URL de produto ou marketing, um roteiro colado ou um briefing em um vídeo de lançamento de produto, incluindo promoções SaaS, revelações de funcionalidades, lançamentos de aplicativos, promoções de empresas e vídeos de marketing de produto.

O que é Lançamento de Produto para HyperFrames?

Esta skill orquestra a criação de vídeos de lançamento de produto de alto nível, guiando o usuário desde um briefing inicial até um vídeo finalizado em formato MP4. Ela suporta plataformas como Claude Code e HyperFrames, automatizando a captura de ativos, design de sistema visual, storyboard e roteiro, seleção de áudio (narração e música), design visual detalhado (com sequências de tomadas codificadas por tempo), construção de quadros HTML e renderização final. A skill é particularmente útil para equipes de marketing e produto que desejam produzir vídeos promocionais de forma eficiente, garantindo que cada quadro se desenvolva ao longo de sua duração, em vez de congelar após a entrada. Ela segue uma arquitetura rigorosa de portões de verificação em cada etapa, garantindo qualidade e consistência, e utiliza blueprints dourados para definir as sequências visuais, evitando a criação de animações do zero.

Funciona com~Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/1345AbhishekKumar/starter-supabase/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/images do catálogo da HeyGen. Execute --adopt primeiro para registrar ativos existentes. Veja a skill /media-use.

O que Lançamento de Produto para HyperFrames faz?

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 etapa, verifique seu portão e só então prossiga para a próxima etapa. Esta skill é para um produto que está sendo comercializado, lançado, promovido ou revelado, incluindo solicitações como "promo para nosso site" quando o objetivo é promocional. Encaminhe outras intenções para outro lugar: um tour geral de site não relacionado a lançamento -> /website-to-video; um explicador de tópico sem produto -> /faceless-explainer; um PR do GitHub -> /pr-to-video; legendas em filmagens existentes -> /embedded-captions; um motion graphic curto sem narração -> /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 as etapas em ordem e passe cada portão antes de continuar. As etapas com portão de usuário são Passo 0, Passo 3 e Passo 6. Faça cada etapa 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 frame-worker, no diretório local ../hyperframes-animation/rules/ + ../hyperframes-animation/blueprints/ desta skill e em hyperframes-creative.

Fluxo de trabalho: Passo 0 configuração -> hyperframes.json; Passo 1 captura -> capture/; Passo 2 sistema de design -> frame.md; Passo 3 storyboard/roteiro -> 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 ausente. Nomeie <project> a partir da marca ou domínio em kebab-case, como acme-promo; nunca use o nome do workspace 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 transmita sua saída literalmente (não parafraseie ou reescreva). Ele informa se a voz/BGM usará mecanismos HeyGen ou locais e, quando não estiver logado, como fazer login. Se não estiver logado, PARE e aguarde a escolha do usuário — fazer login, ou dizer "go"/"offline" para continuar com mecanismos locais — antes de perguntar sobre o briefing ou qualquer outra coisa. Trate como um ponto de decisão real, não uma nota passageira; não incorpore 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 fixados; o status de login foi mostrado (logado ou continuando offline).


Passo 1: Capturar Ativos

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

Classifique a entrada e escolha o caminho. URL explícita -> capture-a e use o site para narração e ativos. Roteiro/briefing colado -> salve literalmente como user_script.txt, pergunte uma vez "usar literalmente ou reestruturar?", armazene a resposta como VO_MODE, depois resolva o destino da captura: URL no texto -> use-a; apenas nome da marca -> WebSearch, confirme a URL em uma linha, depois 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 adiciona automaticamente legendas aos ativos 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 title/description a partir do briefing quando possível. visible-text.txt contém o briefing ou roteiro completo. asset-descriptions.md deve dizer que nenhum ativo foi capturado, a menos que o usuário tenha fornecido notas de ativos.

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 ativos. Se estiver ausente após a captura real, pare e relate captura incompleta. Se capture/BLOCKED.md existir, siga-o.


Passo 2: Sistema de Design

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

Você faz o único julgamento — qual preset. Leia ../hyperframes-creative/references/design-spec.md e escolha o preset cuja aparência melhor se adapta à marca e ao briefing. Em seguida, execute:

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

O script faz o resto deterministicamente: copia o FRAME.md do preset para frame.md e remixa nos tokens da marca em capture/extracted/tokens.json (cores da marca mapeadas nas chaves de cores do preset por função — tinta, tela, acentos — mantendo chaves/estrutura/componentes; as fontes de exibição + corpo do preset são 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 a próxima etapa 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); ajuste frame.md manualmente depois apenas 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 fornece um) .hyperframes/caption-skin.html existe como a fonte da skin de legenda.


Passo 3: Storyboard e Roteiro

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

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 o blueprint da história, gancho, lógica de persuasão, batidas, VO_MODE e escolhas de ativos. Como um guia flexível, consulte o menu função→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 os 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 ativos, a menos que esse inventário esteja ausente ou inutilizável. Use os campos exatos exigidos das referências de storyboard e roteiro.

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 eles desejam uma prévia ao vivo do esqueleto do storyboard (npx hyperframes preview) — abra-o apenas com um 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, temporização de palavras, música e metadados de áudio a partir do roteiro aprovado.

Inicie o áudio após a aprovação do Passo 3. Execute-o em segundo plano e depois 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, temporização de palavras, consulta BGM da biblioteca de música da HeyGen e metadados de temporização. O clima do BGM vem do campo music: do storyboard. Isso usa a API de Áudio da HeyGen para recuperação, não para geração, e usa a mesma credencial ~/.heygen que 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 clima de música.

Portão: o trabalho de áudio foi iniciado 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 codificada por tempo, o vocabulário de Layout inline e o bloco ## Video direction exigido). 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 codificada por tempo em STORYBOARD.md de acordo com o método de visual-design.md: escolha o blueprint do quadro (ou componha), instancie-o com o conteúdo DESTE produto e ritme a revelação de cada Cena para a narração, de modo 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 em todo o vídeo.

Não altere história, roteiro, escolhas de ativos, asset_candidates, transition_in ou material de origem capturado. Não escreva HTML nesta etapa.

Prepare ativos nomeados após o design visual estar fixado:

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

Portão: cada quadro visual tem uma sequência de tomadas codificada por tempo cujas revelações são ritmadas para a narração (sem carregamento no início); ## Video direction existe; assets/ contém os ativos 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 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 de 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 de regra local (../hyperframes-animation/rules/<id>.md) para cada movimento citado e o template do blueprint do quadro (../hyperframes-animation/blueprints/<id>.md). Cada worker escreve apenas compositions/frames/NN-*.html. Workers nunca devem editar STORYBOARD.md.

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

Após as temporizações de áudio existirem, construa 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, renderiza o pill padrão embutido. captions: skipped (<reason>) é válido. Continue sem legendas quando explicitamente pulado.

Portão: cada quadro está marcado como animated, index.html existe e as legendas sã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.

Injete transições, execute verificações, pause para revisão e depois renderize.

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, siga em frente — não demore aqui.

Se um comando falhar, exiba stderr e pare — não acumule comandos de recuperação. Conserte você mesmo: a edição segura mais barata em compositions/frames/NN-*.html e, em seguida, reexecute 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á está revisando no Studio.

Prévia: npx hyperframes preview

Renderize

Individual skills in this repo

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

1345AbhishekKumar/starter-supabase

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-supabase

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-supabase

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-supabase

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-supabase

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-supabase

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-supabase

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-supabase

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-supabase

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-supabase

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-supabase

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-supabase

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-supabase

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