Communitygithub.com

nateherkai/hyperframes-student-kit

Planeje, escreva, cronometre, estilize e valide batidas de motion graphics para vídeos HyperFrames com cabeça falante de longa duração. Use quando o Codex for solicitado a adicionar ou melhorar batidas visuais, terços inferiores em vidro fosco, tomadas de tela cheia em papel amassado, chamadas sincronizadas com transcrição, cobertura de ritmo, gráficos de retenção do YouTube ou sobreposições prontas para renderização em um projeto de vídeo HyperFrames existente.

O que é hyperframes-student-kit?

Este skill capacita o agente Codex a transformar um vídeo com cabeça falante e sua transcrição em uma sequência ritmada de motion graphics que apoiam a narração sem esconder o apresentador. Ele estabelece uma abordagem estratégica: cada batida visual deve responder a uma pergunta específica sobre o que o espectador deve lembrar, qual conceito precisa de estrutura visual ou onde o ritmo pode perder a atenção. O skill detalha dois tipos principais de batida—tomadas de tela cheia em papel amassado para teses e estatísticas impactantes, e cartões de vidro fosco no terço inferior para explicações e suporte contínuo—com regras claras para uso, duração e estilo tipográfico. Inclui heurísticas de ritmo para vídeos longos no YouTube, métodos de temporização baseados em tópicos da transcrição, diretrizes de escrita para compreensão rápida de relance e regras de implementação específicas do HyperFrames, como atributos `data-start`/`data-duration`, rastreamento de linhas do tempo GSAP e uso do linter `npx hyperframes lint`. O resultado é um fluxo de trabalho completo de planejamento, criação, validação e ajuste fino de batidas visuais que mantêm o espectador engajado e orientado.

Funciona com~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/nateherkai/hyperframes-student-kit/tree/HEAD/.agents/skills/hyperframes-video-beats

Perguntar na sua IA favorita

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

Documentação

Batidas de Vídeo HyperFrames

Use este skill para transformar um vídeo com cabeça falante mais transcrição em um conjunto ritmado de motion graphics que apoiam a narração sem cobrir desnecessariamente o apresentador.

Objetivo Central

Mantenha o espectador orientado e engajado. Cada batida deve responder a uma destas perguntas:

  • O que o espectador deve lembrar?
  • Qual conceito precisa de estrutura visual?
  • Que estatística, contraste ou ponto de virada merece destaque?
  • Onde o ritmo está ficando silencioso o suficiente para que o espectador possa se distrair?

Não adicione gráficos apenas porque existe uma lacuna. Adicione gráficos porque a narração tem um tópico, transição, ponto de prova ou modelo mental que se beneficia de suporte visual.

Primeira Passada

  1. Leia as instruções do projeto (AGENTS.md, documentos de skill locais e notas específicas do projeto).
  2. Inspecione a composição raiz, o cronograma atual de batidas, o CSS compartilhado e a transcrição.
  3. Construa um mapa de cobertura a partir das entradas data-start / data-duration da raiz ou do array SHOW mestre.
  4. Extraia trechos da transcrição para qualquer região solicitada e para quaisquer lacunas descobertas.
  5. Identifique intervalos de tópicos pela narração, não por timestamps arbitrários.
  6. Decida se cada tópico precisa de uma batida de tela cheia em papel, um cartão de vidro no terço inferior ou nenhuma nova batida.

Use comandos locais rápidos. Prefira rg, Select-String e pequenos scripts Node/PowerShell para manipular a transcrição.

Tipo de Batida: Decisão

Usar Tela Cheia em Papel Amassado

Use uma tomada de papel quando a narração atingir uma tese principal, lista, marcador de seção, citação ou estatística que deva brevemente ocupar todo o quadro.

Bons usos:

  • Retorno do gancho ou visão geral "neste vídeo"
  • Transição importante de seção
  • Grande estatística ou resultado de estudo
  • Linha de tese memorável
  • Citação curta ou mantra
  • Contraste que precisa fazer o público parar e olhar

Regras:

  • Mantenha curto, geralmente 4 a 12 segundos.
  • Use texto preto esparso.
  • Deixe apenas números de estatísticas verdadeiras ou uma palavra extremamente importante usar cor de destaque.
  • Não cubra explicações longas com tomadas de papel.
  • Não torne o texto em tela cheia lúdico, enorme ou excessivamente ousado por padrão.

Usar Terço Inferior em Vidro Fosco

Use um terço inferior de vidro quando o apresentador deve permanecer visível e o gráfico deve apoiar a ideia atual.

Bons usos:

  • Estruturas de explicação
  • Rótulos de tópico
  • Modelos mentais em estilo de equação
  • Listas pequenas
  • Traduções do tipo "O que isso significa"
  • Preenchimento de ritmo durante longos trechos de cabeça falante
  • Cartões de acompanhamento após uma batida encurtada de tela cheia ou tela dividida

Regras:

  • Mantenha os terços inferiores na parte inferior ou na metade inferior.
  • Evite cobrir o rosto.
  • Use texto conciso: um título mais uma legenda curta opcional, ou uma lista de 2 a 4 itens.
  • Prefira um cartão por intervalo de tópico em vez de muitos flashes pequenos.
  • Preserve o estilo existente de cartão de vidro, a menos que o usuário solicite uma alteração de design.

Heurísticas de Ritmo

Para vídeos longos de cabeça falante no YouTube:

  • Início do vídeo: evite mais de 20 a 30 segundos sem uma batida visual.
  • Corpo principal: evite mais de 30 a 45 segundos sem uma batida.
  • Seções de explicação densa: use terços inferiores aproximadamente a cada intervalo de tópico, não a cada frase.
  • Grandes tomadas de papel devem ser pontuação ocasional, não o padrão.
  • Se uma batida existente foi manualmente encurtada porque parecia longa demais, respeite essa escolha e preencha depois dela com um novo cartão mais curto.

Ao escanear um cronograma, relate lacunas verdadeiras a partir do cronograma de visibilidade, não apenas da ordem do DOM. Se a linha do tempo raiz usar um array SHOW, esse é geralmente o intervalo visível autoritativo.

Método de Temporização

Cronometre cada batida de acordo com o tópico da transcrição:

  1. Encontre a primeira palavra ou frase onde o tópico começa.
  2. Inicie a batida 0,2 a 0,6 segundos antes desse âncora, quando possível.
  3. Mantenha a batida visível até que o tópico termine ou passe naturalmente.
  4. Se a próxima batida começar imediatamente, limpe 0,1 a 0,5 segundos antes dela, a menos que a transição seja intencional.
  5. Corresponda as entradas de subelementos às frases faladas.

Evite este modo de falha:

  • O cartão aparece no tópico certo, mas dura apenas 5 a 8 segundos enquanto o apresentador continua discutindo o tópico por 20 a 40 segundos.

Prefira:

  • Um cartão cobre todo o tópico, com uma legenda ou item de lista sendo construído no meio se a narração evoluir.

Escrita de Conteúdo

Escreva para compreensão de relance. O espectador deve entender o cartão em menos de um segundo.

Use:

  • Frases nominais curtas
  • Rótulos diretos
  • Um modelo mental por cartão
  • Números apenas quando forem significativos
  • Verbos quando esclarecerem a ação

Evite:

  • Repetir toda a narração
  • Frases longas
  • Linguagem de hype vaga
  • Muitas palavras destacadas
  • Explicar como usar o vídeo dentro do gráfico

Bons padrões:

O gargalo
Não há IA suficiente dentro dos fluxos de trabalho reais.
O problema é a adoção, não o talento bruto.
A ponte
Habilidades + Fluxos de Trabalho = 40 horas economizadas
Neste vídeo
-> O estudo
-> As estatísticas
-> Os caminhos que você pode seguir
-> O que realmente importa

Regras de Estilo Visual

Siga primeiro o sistema de design local. Para esta família de projetos, use:

  • Tipografia profissional séria.
  • Texto primário preto em batidas de papel.
  • Azul de destaque apenas para números de estatísticas principais ou palavras de poder raras.
  • Cartões de vidro com o estilo escuro fosco existente.
  • Cartões de terço inferior que não cubram o rosto do apresentador.

Para batidas de papel:

  • Use preto para chamadas, rótulos, setas, fontes, citações e texto de apoio.
  • Mantenha o peso da fonte contido.
  • Evite tipos lúdicos superdimensionados, a menos que o usuário peça explicitamente.
  • Torne o movimento do papel amassado determinístico.

Para cartões de vidro:

  • Reutilize .glass-card dim lower-third ou a classe existente mais próxima.
  • Prefira posicionamento central inferior.
  • Mantenha os cartões compactos.
  • Use ajudantes de equação/lista quando a ideia for estrutural.

Regras de Implementação HyperFrames

Siga o AGENTS.md do projeto e as regras de lint do HyperFrames:

  • Todo elemento temporizado montado precisa de data-start, data-duration e data-track-index.
  • Elementos visíveis montados na raiz devem ter a classe de clipe/camada esperada usada pelo projeto.
  • Subcomposições devem registrar uma linha do tempo GSAP pausada em window.__timelines.
  • Fixe cada linha do tempo de subcomposição com tl.set({}, {}, SLOT);.
  • Mantenha apenas lógica determinística.
  • Não anime dimensões de elementos de vídeo ou propriedades de mídia de forma que possa congelar renderizações.
  • Execute npx hyperframes lint após editar o HTML.

Ao adicionar uma batida:

  1. Crie compositions/beats/NNN-short-name.html.
  2. Adicione a montagem raiz em index.html.
  3. Adicione ou atualize o cronograma de visibilidade mestre se existir um.
  4. Faça o SLOT da subcomposição corresponder à duração montada.
  5. Verifique se não há sobreposições no mesmo trilho, a menos que o projeto use intencionalmente múltiplos trilhos de sobreposição.

Escaneamento de Cobertura

Após as edições, escaneie o cronograma mestre:

  • Liste as batidas ordenadas pelo início visível.
  • Imprima lacunas acima do limite alvo.
  • Adicione ou reajuste batidas apenas onde a transcrição tiver um conceito com suporte.

Para este padrão de projeto, use 30 segundos como limite estrito de escaneamento e 45 segundos como limite máximo aceitável para o corpo principal.

Validação

Antes de finalizar:

  1. Execute o linter do HyperFrames.
  2. Corrija todos os erros.
  3. Mencione avisos separadamente se forem conhecidos e não bloqueadores.
  4. Se o usuário pediu saída pronta para renderização, renderize ou faça uma renderização de teste conforme apropriado.
  5. Forneça ao usuário os caminhos de arquivo exatos e os timestamps alterados.

Padrões Práticos

Use estes padrões a menos que o contexto do projeto diga o contrário:

  • Visão geral de tela cheia em papel: 8 a 10 segundos.
  • Estatística de tela cheia em papel: 5 a 8 segundos.
  • Explicação em terço inferior de vidro: 12 a 30 segundos.
  • Cartão de vidro para tópico longo: 25 a 45 segundos com subelementos escalonados.
  • Início de batida com lead-in: 0,2 a 0,6 segundos.
  • Limite de escaneamento de lacunas: 30 segundos.
  • Largura do terço inferior: cerca de 68 a 72 vw, máximo de cerca de 1240 a 1280 px.

O Que Preservar

Preserve as decisões de gosto do usuário descobertas durante a revisão:

  • Se o usuário disser que uma batida é longa demais, não a restaure apenas para satisfazer uma regra genérica de cobertura.
  • Se o estilo de cartão de vidro foi aprovado, reutilize-o em vez de redesenhar.
  • Se a tipografia foi aprovada, mantenha-a estável e ajuste apenas o tamanho/peso local.
  • Se o rosto do apresentador for importante, prefira cartões de terço inferior em vez de cartões no centro da tela.

Individual skills in this repo

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

nateherkai/hyperframes-student-kit

Agent 2 of the video editing pipeline. Finds and removes spoken mistakes — stutters, repeated words, false starts, and retakes (re-recorded lines) — from a talking-head recording. Use after cut-silences, when asked to cut mistakes, remove stutters / repeats / filler restarts, clean up flubs, or keep the best take. Works review-gated: it proposes every cut with context and a reason for approval, then renders only the approved cuts via ffmpeg. Requires a word-level transcript.

nateherkai/hyperframes-student-kit

Agent 1 of the video editing pipeline. Removes silences and dead air from a talking-head recording. Use when asked to cut silences, trim pauses, remove dead air / gaps, or tighten the pacing of a raw video, given a word-level transcript. Produces an edit list (EDL), a re-timed transcript for downstream agents, and optionally the cut video via ffmpeg. Does NOT cut mistakes, repeats, or false starts — that is the cut-mistakes agent.

nateherkai/hyperframes-student-kit

Edit a raw talking-head video through transcription, silence trimming, mistake review, visual storytelling, motion graphics, and verified HyperFrames rendering. Use for a complete edit; route a single requested operation directly to its specialist skill.

nateherkai/hyperframes-student-kit

GSAP animation reference for HyperFrames. Covers gsap.to(), from(), fromTo(), easing, stagger, defaults, timelines (gsap.timeline(), position parameter, labels, nesting, playback), and performance (transforms, will-change, quickTo). Use when writing GSAP animations in HyperFrames compositions.

nateherkai/hyperframes-student-kit

HyperFrames CLI tool — hyperframes init, lint, preview, render, transcribe, tts, doctor, browser, info, upgrade, compositions, docs, benchmark. Use when scaffolding a project, linting or validating compositions, previewing in the studio, rendering to video, transcribing audio, generating TTS, or troubleshooting the HyperFrames environment.

nateherkai/hyperframes-student-kit

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, and registry discovery.

nateherkai/motion-showreel

Build 10–30s motion-design showreels in the style of Nate's Opus 5.5 CLAUDE/MOTION REEL — brand motif chapters, HUD, BPM-locked cuts, logo lockup.

nateherkai/website-to-hyperframes

Capture a website URL and produce a HyperFrames promo/product-tour video — site → finished marketing video outcome.

Habilidades Relacionadas