Communitygithub.com

1345AbhishekKumar/starter-nextjs

Capture um site/URL genérico e transforme-o em um vídeo HyperFrames (tour do site, showcase ou clipe social a partir dos visuais do próprio site).

O que é starter-nextjs?

Esta skill permite que agentes de IA, como Claude Code ou Cursor, capturem qualquer site ou URL e o convertam em um vídeo profissional utilizando a plataforma HyperFrames. O foco principal é a criação de vídeos para portfólios, blogs, landing pages ou clipes sociais, aproveitando os próprios visuais e assets do site. O processo é altamente estruturado em 7 etapas, que vão desde a captura inicial e análise da marca até a validação final e entrega do projeto. A skill inclui verificações rigorosas de qualidade, como auditoria de assets, leitura de composições por batida e verificação de acessibilidade (WCAG), garantindo um resultado refinado. É importante notar que esta skill não se destina a vídeos de lançamento de produtos, explicadores sem site ou clipes com movimentos gráficos curtos sem narração; para esses casos, existem skills específicas como `/product-launch-video` ou `/faceless-explainer`. O agente também deve verificar o status de autenticação do HyperFrames e o modo de operação (colaborativo ou autônomo) para seguir o fluxo correto.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/1345AbhishekKumar/starter-nextjs/tree/HEAD/.agents/skills/website-to-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, execute /media-use para resolver BGM/SFX/imagens do catálogo HeyGen. Execute --adopt primeiro para registrar assets existentes. Consulte a skill /media-use.

Site para HyperFrames

Capture um site e produza um vídeo profissional a partir dele.

Confirme a rota antes do Passo 0. Esta skill faz um vídeo de / a partir de um site genérico. Se o usuário está realmente fazendo marketing / lançando / promovendo um produto (mesmo a partir desta URL, mesmo "promoção do nosso site") → /product-launch-video. Um explicador de tópico sem site → /faceless-explainer; um PR do GitHub → /pr-to-video; re-cortar / recolorir / reordenar um arquivo de vídeo existente → fora do escopo. Roteado aqui em um vago "criar um vídeo", ou não tem certeza entre lançamento vs. site genérico? Leia /hyperframes primeiro (tabela de roteamento completa + § O que o HyperFrames não pode fazer).

Os usuários dizem coisas como:

  • "Transforme este site em um clipe social de 15 segundos para o Instagram"
  • "Faça um tour / showcase de 30 segundos do site a partir de https://..."
  • "Capture nossa página inicial e construa um vídeo a partir de seus próprios visuais"

O fluxo de trabalho tem 7 etapas. Cada uma produz um artefato que autoriza a próxima. Por padrão, é colaborativo — as portas marcadas com 💬 param e perguntam ao usuário. Se o usuário sinalizar modo autônomo ("decida por mim", "me surpreenda"), as portas de preferência do usuário 💬 são ignoradas; veja step-2-brief.md para saber como isso se propaga.

Modo autônomo NÃO é "pular todas as portas." O modo automático cobre perguntas de preferência do usuário (provedor TTS, voz, ênfase de cor, contagem de batidas, música sim/não, legendas sim/não — onde o agente decide em nome do usuário). Ele NÃO cobre portas de verificação de qualidade. As seguintes permanecem não-saltáveis no modo autônomo:

  • Auditoria de Assets (Passo 3) — visualizar folhas de contato e justificar USE/SKIP para cada asset
  • Leitura de HTML por batida (Passo 5) — bloco de evidências estruturado por batida
  • Lista de verificação DoD (Passo 6) — incluindo mapa de animação, verificação WCAG por aviso, reprodução de áudio/movimento
  • Seção de divulgação honesta (Passo 6) — "O que eu NÃO verifiquei" deve aparecer em seu resumo final

Se você se pegar pensando "modo autônomo diz viés para ação, então vou pular X" — e X é uma porta de verificação, não uma questão de preferência — esse raciocínio está errado. Viés para ação se aplica a decidir o que construir, não a decidir se deve verificar.


Passo 0: Capture e Entenda a Marca

Leia: references/step-0-capture.md

Capture o site, depois leia os dados extraídos para entender a marca e o produto — o que faz, para quem é, em que voz fala, em que humor vive. Os assets capturados são um kit de ferramentas da marca para uso posterior, não os blocos de construção dos quais o vídeo é feito.

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á motores 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 motores 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 transforme a escolha na pergunta do briefing e não escreva chaves em um .env por repositório. (No modo autônomo, observe o status e continue offline.) Consulte ../hyperframes-media → Preflight para a orientação canônica.

Porta: Resumo do site impresso — estratégia primeiro (o que o produto faz, para quem é, voz da marca) antes do inventário de assets / cores / fontes; o status de login foi mostrado (logado, ou continuando offline).


Passo 1: Identidade da Marca

Leia: references/step-1-design.md

Escreva DESIGN.md — uma folha de consulta rápida da marca cobrindo a identidade visual: cores, tipografia, estilos de componentes, princípios de layout. Use design-styles.json para valores computados exatos.

Opção de velocidade: Para vídeos de ritmo rápido (batidas de outdoor), DESIGN.md pode ser um resumo de 50 linhas de cores + fontes + o que fazer/não fazer — não um documento de 300 linhas. O prompt do sub-agente no Passo 5 cola os valores da marca diretamente, então a profundidade do DESIGN.md só importa para composições complexas.

Porta: DESIGN.md existe (qualquer tamanho) com, no mínimo: paleta de cores, escolhas de fonte e o que fazer/não fazer.


Passo 2: Estratégia e Mensagem

Leia: references/step-2-brief.md, references/capabilities.md (varra o Índice — seções de aprofundamento apenas conforme necessário)

Alinhe com o usuário sobre o que o vídeo deve comunicar antes de falar sobre visuais ou assets. Analise o prompt do usuário — ele provavelmente já lhe deu o tipo e estilo de vídeo. Pergunte apenas o que está faltando: a ÚNICA coisa que este vídeo deve dizer, o arco narrativo e o público.

Porta: Tipo de vídeo, duração, formato e — criticamente — a mensagem e o arco narrativo estão definidos. Sem eles, o Passo 3 não pode escrever um storyboard baseado em conceito.


Passo 3: Storyboard + Roteiro 💬

Leia: references/step-3-storyboard.md

Escreva o storyboard com foco primeiro no conceito: mensagem → arco narrativo → batidas que servem ao arco → técnicas por batida → passagem de acentos da marca no final. Em seguida, escreva o roteiro de narração correspondente. Apresente ambos ao usuário com um resumo batida por batida. Itere até que ele aprove.

Porta: STORYBOARD.md + SCRIPT.md existem E o usuário aprovou o plano.


Passo 4: Locução, Tempo e Legendas 💬

Leia: references/step-4-vo.md

Se o Passo 2 disse sem narração — pergunte sobre música de fundo, depois pule para o Passo 5. Caso contrário: pergunte ao usuário qual provedor TTS (HeyGen TTS, ElevenLabs ou Kokoro), gere áudio, transcreva, mapeie timestamps para batidas. Depois pergunte sobre legendas.

Porta: (a) Nenhuma narração foi solicitada e o storyboard tem tempos de batida manuais, ou (b) narration.wav + transcript.json existem e os tempos de batida foram atualizados com durações reais.


Passo 5: Construir Composições

Leia: A skill hyperframes (carregue-a — cada regra importa) Leia: references/step-5-build.md

Construa index.html e as composições seguindo a arquitetura e o ritmo escolhidos no storyboard (Passo 3). Sub-agentes executam hyperframes lint e hyperframes snapshot em cada batida antes de relatar de volta.

Porta: Cada compositions/beat-N.html foi lido de cima a baixo pelo agente principal em relação a DESIGN.md e STORYBOARD.md. A lista de verificação por batida está em step-5-build.md.


Passo 6: Validar e Entregar

Leia: references/step-6-validate.md

Linte, valide, tire snapshots dimensionados para a duração do vídeo (fórmula: max(batidas × 3, ceil(duração_em_segundos / 2))) e revise cada um. Corrija problemas antes de entregar. Entregue a URL do projeto Studio localhost — renderize para MP4 apenas sob solicitação explícita do usuário. Exiba a URL do Studio apenas na entrega — ela é a pré-visualização final e estável; os snapshots da fase de construção são headless, portanto não abra uma pré-visualização no meio da construção.

Entregue algo de que você se orgulhe. Antes de entregar, pergunte-se: eu postaria isso nas redes sociais com meu nome? Se não, corrija o que está errado.

Porta: npx hyperframes lint e npx hyperframes validate passam com zero erros, e a resposta final inclui a URL ativa do projeto Studio.


Referência Rápida

Tipos de Vídeo

Restrições típicas por tipo de vídeo — use como ponto de partida, não como fórmula. A contagem de batidas deve decorrer do conteúdo e da narração, não de uma faixa alvo.

TipoDuração típicaDirecionador de duraçãoNarração
Anúncio social (IG/TikTok)10–15sLimite da plataformaOpcional
Demonstração de produto30–60sComprimento do roteiroNarração completa
Anúncio de funcionalidade15–30sComplexidade da funcionalidadeNarração completa
Reel de marca20–45sFaixa de músicaOpcional, foco na música
Teaser de lançamento10–20sEnergia do ganchoMínima

A contagem de batidas não está nesta tabela intencionalmente — ela deve vir do storyboard, não de "anúncio social = 3-4 batidas". Um anúncio social para um produto complexo pode precisar de 5 batidas bem cronometradas. Um reel de marca com uma tese visual forte pode precisar de 3.

Formato

  • Paisagem: 1920x1080 (padrão)
  • Retrato: 1080x1920 (Instagram Stories, TikTok)
  • Quadrado: 1080x1080 (feed do Instagram)

Arquivos de Referência

ArquivoQuando ler
step-0-capture.mdPasso 0 — capturar, entender a marca e o produto, escrever resumo do site com estratégia primeiro
step-1-design.mdPasso 1 — escrever DESIGN.md folha de consulta da marca (5 seções, 250-350 linhas; caminho rápido de 50 linhas para anúncios sociais estilo outdoor)
step-2-brief.mdPasso 2 — alinhar mensagem, arco narrativo, público com o usuário
capabilities.mdPassos 2 e 5 — inventário completo do que o HyperFrames pode fazer (24 seções). Varra o Índice durante o briefing, aprofunde seções específicas durante a construção
step-3-storyboard.mdPasso 3 — storyboard + roteiro (combinados) com porta de revisão do usuário
step-4-vo.mdPasso 4 — escolha do provedor TTS, geração, tempo
step-5-build.mdPasso 5 — construir index.html + composições
step-6-validate.mdPasso 6 — lint, validar, snapshots (dimensionados para a duração do vídeo), pré-visualização
techniques.mdPassos 3 e 5 — 13 técnicas de animação primitivas com padrões de código (adapte, não copie e cole)
html-in-canvas-patterns.mdPasso 5 — padrões de código completos para efeitos HTML-em-Canvas (vive na skill hyperframes)

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 product or marketing URL, pasted script, or brief into a product launch video, including SaaS promos, feature reveals, app launches, company promos, and product marketing videos. Use this skill when the user wants to market, launch, promote, or reveal a product. Do not use it for general non-launch website tours, non-product topic explainers, GitHub pull requests, captioning existing footage, or short unnarrated motion graphics. If the intent is unclear, route through /hyperframes first. This is the new shot-sequence architecture: every visual frame is authored as a time-coded shot sequence picked from a menu of golden blueprints, so frames develop over their full duration instead of freezing after entrance.

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.

Habilidades Relacionadas