Communitygithub.com

1345AbhishekKumar/starter-nextjs

Fluxo de trabalho genérico para criar composições de vídeo HyperFrames personalizadas de qualquer duração ou formato — peças longas ou com várias cenas, reels de marca/montagens, cards de título, loops estáticos e composições livres. Agnóstico em relação à entrada e duração. Se um workflow especializado se encaixar claramente na entrada — um produto comercializado, um site, um explicador de tópico, um PR do GitHub, filmagens existentes, um motion graphic curto ou uma adaptação do Remotion — prefira-o (consulte /hyperframes); use este apenas como alternativa genérica quando nenhum se encaixar.

O que é starter-nextjs?

Este skill define o workflow genérico para a criação de composições de vídeo personalizadas usando o HyperFrames. Ele atua como um fallback abrangente para projetos que não se enquadram em fluxos de trabalho especializados, como vídeos de lançamento de produto ou explicadores de tópicos. O skill enfatiza uma abordagem estruturada: primeiro, estabelece um sistema de design e um ângulo conceitual, seguido pelo planejamento da estrutura, ritmo e layout antes da animação. As principais práticas incluem a construção do estado final do layout primeiro (HTML/CSS estático) e a adição de animações com GSAP, garantindo que todos os elementos estejam corretamente posicionados antes de adicionar movimento. O skill também se integra a um motor de áudio centralizado para TTS, BGM e SFX, e delega tarefas específicas (como animação ou composição de áudio) a skills de domínio especializados dentro do ecossistema HyperFrames. Destina-se a usuários que precisam criar conteúdo de vídeo flexível e de alta qualidade, quando nenhum outro modelo pré-definido se aplica.

Funciona com~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/1345AbhishekKumar/starter-nextjs/tree/HEAD/.agents/skills/general-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 HeyGen. Execute --adopt primeiro para registrar ativos existentes. Consulte o skill /media-use.

general-video — workflow de vídeo geral

Confirme a rota antes de construir. Este é o fallback para criação de composições personalizadas. Se a entrada se encaixa claramente em um workflow especializado, prefira-o: produto comercializado → /product-launch-video; site genérico → /website-to-video; explicador de tópico → /faceless-explainer; PR do GitHub → /pr-to-video; filmagens existentes → /embedded-captions · /talking-head-recut; motion graphic curto sem narração → /motion-graphics; adaptação do Remotion → /remotion-to-hyperframes. Fora do escopo: dados ao vivo/no momento da renderização, edição no estilo NLE de um vídeo finalizado, ou produção de filmagens que o HyperFrames não pode capturar. Não tem certeza? Leia /hyperframes primeiro.

Construa exatamente o que foi solicitado. Um card de título é um card de título — não um card de título + três cenas de apoio + música ambiente + legendas. Se cenas ou elementos extras realmente melhorariam a peça, proponha-os; não os adicione silenciosamente. Para pequenas edições (corrigir uma cor, ajustar uma duração, adicionar um elemento), pule as etapas de planejamento e vá direto para a construção.

Abordagem

Descoberta — apenas para solicitações abertas

Para solicitações vagas e exploratórias ("faça algo para nossa marca", "uma introdução legal") — entenda a intenção antes de escolher cores:

  • Público — quem assiste? desenvolvedores / executivos / consumidores em geral?
  • Plataforma — onde é veiculado? social (15s) / hero do site / demo de produto / interno?
  • Prioridade — o que é mais importante? qualidade do movimento / precisão do conteúdo / fidelidade à marca / velocidade?
  • Variações — uma melhor tentativa, ou 2-3 opções significativamente diferentes (ritmo, energia ou estrutura diferentes — não apenas trocas de cor)?

Para solicitações específicas ("adicione um card de título", "corrija o timing da cena 3"), pule a descoberta.

Etapa 1 — Sistema de design → hyperframes-creative

Estabeleça a identidade visual primeiro. Se o projeto tiver uma especificação de design, leia-a (precedência frame.md → design.md → DESIGN.md; trate-a como verdade da marca — cores, fontes, restrições exatas).

Se não houver especificação, você DEVE ler AMBOS hyperframes-creative/references/house-style.md E hyperframes-creative/references/video-composition.md antes de escolher qualquer cor ou fonte. house-style.md fornece a abertura "interpretar o prompt / gerar conteúdo real", lista lazy-default e receita de camadas; video-composition.md fornece a densidade/escala do meio de vídeo / detalhamento do primeiro plano (barras de dados, marcas de registro, metadados monoespaçados, "8-10 elementos, dois que o usuário não pediu") que separa "produzido" de "gerado". Ler apenas um é o erro mais comum — video-composition.md é aquele que os agentes pulam, e é exatamente o que impede saídas planas, centradas e com aparência de página da web. Não invente uma paleta e pule estes; cruzar para hyperframes-creative é obrigatório aqui, não um ramo opcional. A partir daí, também extraia um estilo/humor nomeado → references/visual-styles.md, ou o seletor interativo → references/design-picker.md, conforme necessário. A especificação/estilo define a marca, não as regras de composição.

Encontre o ângulo (briefing vago, sem especificação): antes de escolher cores, escreva UMA frase — o que este nome/palavra/tópico evoca, e qual mundo visual (metáfora, cenário, instrumento, motivo) o expressa? Ex.: uma ferramenta de cibersegurança → portas de cofre / linhas de varredura de perímetro / tambores de fechadura; um app de meditação → maré, respiração, lenta floração de luz. Leia o significado do assunto, não apenas suas letras; escolha um ângulo concreto em vez de uma reformulação literal. Este é o substituto barato para a expansão de prompt (Etapa 2) em peças de cena única, onde a expansão é corretamente ignorada — e é a diferença entre um conceito projetado e um logotipo genérico em um gradiente.

Etapa 2 — Expansão de prompt → hyperframes-creative

Execute para toda composição com várias cenas (pule para peças de cena única e edições triviais). Fundamente a solicitação contra a especificação de design + estilo da casa em um intermediário consistente que o trabalho downstream leia da mesma forma. Consulte hyperframes-creative/references/prompt-expansion.md.

Etapa 3 — Planejamento

Antes de escrever HTML, pense em alto nível:

  1. O quê — a experiência do espectador: arco narrativo, momentos-chave, batidas emocionais.
  2. Estrutura — quantas composições, sub-comp vs inline, quais faixas carregam vídeo / áudio / sobreposições / legendas. Para a decisão de arquivo monolítico-único vs sub-comp modular, consulte hyperframes-core/references/composition-patterns.md § Duas Arquiteturas (regra prática: ≥3 cortes de cena duros, ou qualquer cena reutilizada → modularize; uma peça curta de cena única permanece um arquivo).
  3. Ritmo — nomeie o padrão antes de implementar (ex.: rápido-rápido-LENTO-SHADER-pausa); consulte hyperframes-creative/references/beat-direction.md.
  4. Timing — quais clipes determinam a duração, onde as transições ocorrem, o ritmo.
  5. Layout — construa o estado final primeiro (veja abaixo).
  6. Animar — depois adicione movimento via hyperframes-animation.

Layout Antes da Animação

Posicione cada elemento onde ele fica em seu momento mais visível — totalmente inserido, corretamente colocado, ainda não saindo. Escreva isso como HTML + CSS estático primeiro. Ainda sem GSAP.

Por quê: se você posicionar elementos em seu estado inicial animado (fora da tela, escalados para 0, opacidade 0) e interpolar para onde você acha que eles vão parar, você está adivinhando o layout final — sobreposições permanecem invisíveis até a renderização. Construa o estado final primeiro e você verá e corrigirá problemas de layout antes de adicionar movimento.

  1. Identifique o quadro herói para cada cena — o momento em que o maior número de elementos está simultaneamente visível. Esse é o layout que você constrói.
  2. Escreva CSS estático para esse quadro. O contêiner de conteúdo deve preencher a cena com preenchimento (padding), não com deslocamentos absolutos:
.scene-content {
  display: flex;
  flex-direction: column;
  justify-content: center;
  width: 100%;
  height: 100%;
  padding: 120px 160px; /* padding posiciona o conteúdo; preenche qualquer tamanho de cena */
  gap: 24px;
  box-sizing: border-box;
}

Nunca use position: absolute; top: Npx em um contêiner de conteúdo — ele transborda quando o conteúdo é mais alto que o espaço. Reserve o posicionamento absoluto para elementos decorativos.

⚠ O width/height: 100% acima só funciona se cada ancestral tiver uma altura resolvida. O <div data-composition-id> raiz e qualquer wrapper entre ele e .scene-content devem ser dimensionados (position: relative; width: 1920px; height: 1080px na raiz — consulte hyperframes-core → "A raiz deve ser dimensionada"). Pule isso e o contêiner flexível colapsa para ~0, o conteúdo se acumula no canto superior esquerdo, e o primeiro glifo corta em x=0 — enquanto lint/inspect ainda relatam 0 problemas. E sempre mantenha o padding (≥80px) em .scene-content: é a margem de segurança do título. Nunca o substitua por gap simples.

  1. Adicione entradas — anime DE fora da tela/invisível PARA a posição CSS com gsap.from() (em sub-composições, prefira gsap.fromTo() para que o estado inicial seja explícito; consulte hyperframes-core/references/sub-compositions.md). A posição CSS é a verdade absoluta; a interpolação é a jornada até ela.
  2. Saídas são tratadas por transições — de acordo com as regras de transição de cena em hyperframes-animation/transitions/, apenas a cena final anima elementos para fora; entre cenas, a transição É a saída.

Espaço compartilhado ao longo do tempo: se o elemento A sai antes do elemento B entrar na mesma área, ambos ainda precisam de posições CSS corretas para seus respectivos quadros herói — a ordenação da linha do tempo impede que coexistem, e a etapa de layout captura sobreposições acidentais. Brilhos/sombras em camadas e profundidade de pilha z são sobreposições intencionais; a etapa é sobre capturar colisões não intencionais (dois títulos em cima um do outro, conteúdo sangrando para fora do quadro).

Construa — delegue aos skills de domínio

Isso mapeia a superfície completa do skill (consulte a description) para suas referências — não exaustivo; quando uma intenção não estiver listada, direcione através de hyperframes-creative (aparência/conceito), hyperframes-animation (movimento), hyperframes-core (contrato), hyperframes-media (áudio/legendas). A primeira linha é ADITIVA — leia-a E sua linha de intenção, não apenas uma ou outra.

Construindo…Leia primeiro (em ordem)
SEMPRE — toda peça não trivial, além da sua linha de intenção abaixohyperframes-creative/references/house-style.md + references/video-composition.md (também verificado na Etapa 1 / HARD-GATE; o detalhamento de primeiro plano "produzido, não gerado")
Tipografia cinética / foco em textohyperframes-animation/techniques.md (tipo cinético) + adapters/gsap-easing-and-stagger.md + rules/kinetic-beat-slam.md
Card de título / terço inferior / sobreposição / PiP / texto atrás do sujeitohyperframes-creative/references/composition-patterns.md + (para o quadro centralizado/dimensionado) hyperframes-core → "A raiz deve ser dimensionada"
Revelação de logotipo / marcahyperframes-animation/rules/svg-path-draw.md (desenho) + rules/3d-text-depth-layers.md + rules/scale-swap-transition.md
Dados / estatísticas / númeroshyperframes-animation/rules/counting-dynamic-scale.md + rules/stat-bars-and-fills.md + hyperframes-creative/references/data-in-motion.md
Demo de produto / app / UIhyperframes-animation/rules/3d-page-scroll.md + rules/cursor-click-ripple.md + rules/press-release-spring.md
Audio-reativo / orientado por músicahyperframes-creative/references/audio-reactive.md (pré-extrair bandas; mapear para movimento)
Narrado / voz over / música / SFX / legendashyperframes-media → o motor de áudio compartilhado scripts/audio.mjs (uma chamada = TTS + BGM + SFX → audio_meta.json); criação de legendas + posicionamento de ativos via hyperframes-core. Consulte Áudio abaixo.
Multi-cena / transiçõeshyperframes-animation/transitions/overview.md depois transitions/catalog.md (você não terminou após a visão geral — a receita GSAP está no catálogo)
Modular / sub-composiçõeshyperframes-core/references/composition-patterns.md + references/sub-compositions.md

Áudio: um motor (TTS · BGM · SFX)

Apenas quando a peça exigir (de acordo com "construa exatamente o que foi solicitado" — sem música ambiente em um card de título). Não crie TTS manualmente nem forneça uma cópia: escreva um audio_request.json neutro e chame o motor compartilhado em hyperframes-media. Ele se degrada automaticamente em um switch — credencial HeyGen presente → HeyGen TTS + recuperação de música/SFX; ausente → ElevenLabs/Kokoro TTS, geração de BGM Lyria/MusicGen e a biblioteca SFX incluída. Lista completa de flags + esquema de requisição/meta: o comentário de cabeçalho de hyperframes-media/scripts/audio.mjs.

// audio_request.json — uma linha por segmento narrado; `id` é seu (une audio_meta de volta)
{
  "lines": [
    { "id": "s1", "text": "Sua linha de abertura.", "sfx": ["whoosh"] },
    { "id": "s2", "text": "A próxima batida." },
  ],
  "bgm": { "query": "calm cinematic underscore" }, // omita "mode" → auto (recuperar se HeyGen, senão gerar); "none" para desativar
}
# <MEDIA_DIR> = o diretório do skill hyperframes-media instalado (irmão deste skill)
node <MEDIA_DIR>/scripts/audio.mjs --request ./audio_request.json --hyperframes . --out ./audio_meta.json

Em seguida, leia audio_meta.json: monte cada voices[].path + (bgm.path, sfx[]) como faixas <audio> e use voices[].words para legendas, tudo conforme hyperframes-core (faixas de áudio + criação de legendas). Se o BGM seguiu o caminho de geração (bgm_pending: true), execute hyperframes-media/scripts/wait-bgm.mjs antes da renderização final.

Lista de verificação de saída → hyperframes-cli

  • [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

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.

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