Communitygithub.com

Sma1lboy/rove

Fluxo de trabalho genérico para criar composições de vídeo HyperFrames personalizadas em qualquer duração ou formato — peças mais longas ou com várias cenas, reels de marca / sizzle, montagens, cartões de título, loops estáticos e composições livres. Independente de entrada e duração. Se um fluxo de trabalho especializado se encaixar claramente na entrada — um produto comercializado, um site, um explicador de tópico, um PR do GitHub, filmagem existente, um motion graphic curto ou uma portabilidade do Remotion — prefira-o (veja /hyperframes); use este apenas como fallback geral quando nenhum se encaixar.

O que é rove?

Este skill é o roteiro de fallback para criação de composições de vídeo personalizadas com a plataforma HyperFrames. Ele é projetado para ser usado quando nenhum dos fluxos de trabalho especializados (como explicadores de tópico, PRs do GitHub, filmagem existente, etc.) se aplica. O skill orienta o agente através de um processo rigoroso que começa com a definição da identidade visual, utilizando os guias de estilo `house-style.md` e `video-composition.md`, e um conceito temático antes de escrever qualquer código. Em seguida, expande o prompt para composições com várias cenas e planeja a estrutura, o ritmo e o layout antes da animação, usando GSAP. O principal ponto forte é garantir que o resultado final seja visualmente produzido e não pareça genérico, com foco em detalhes de primeiro plano, texturas de fundo e layout intencional. O skill suporta exclusivamente a plataforma HyperFrames e depende de suas bibliotecas (`hyperframes-design`, `hyperframes-motion`, `/hyperframes/core`) para implementação.

Funciona com~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/Sma1lboy/rove/tree/HEAD/.claude/skills/general-video

Perguntar na sua IA favorita

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

Documentação

general-video — fluxo de trabalho de vídeo geral

Confirme a rota antes de construir. Este é o fallback para criação de composições personalizadas. Se a entrada se encaixar claramente em um fluxo de trabalho especializado, prefira-o: explicador de tópico → /faceless-explainer; PR do GitHub → /pr-to-video; filmagem existente → /embedded-captions · /talking-head-recut; motion graphic curto sem narração → /motion-graphics. Fora do escopo: dados ao vivo / no momento da renderização, edição 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 cartão de título é um cartão de título — não um cartão de título + três cenas de apoio + legendas. Se cenas ou elementos extras realmente melhorarem 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 ("crie algo para nossa marca", "uma introdução legal") — entenda a intenção antes de escolher as cores:

  • Público — quem assiste? desenvolvedores / executivos / consumidores em geral?
  • Plataforma — onde será exibido? rede social (15s) / herói do site / demonstração 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 cartão de título", "corrija o tempo da cena 3"), pule a descoberta.

Etapa 1 — Sistema de design → hyperframes-design

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 TANTO hyperframes-design/references/house-style.md QUANTO hyperframes-design/references/video-composition.md antes de escolher qualquer cor ou fonte. house-style.md fornece a abertura "interpretar o prompt / gerar conteúdo real", a lista de fallback lazy e a receita de camadas; video-composition.md fornece as regras de densidade / escala / detalhamento de primeiro plano (barras de dados, marcas de registro, metadados monoespaçados, "8-10 elementos, dois que o usuário não pediu") que separam o "produzido" do "gerado". Ler apenas um é o erro mais comum — video-composition.md é aquele que os agentes pulam, e é exatamente o que evita uma saída plana, centralizada e com aparência de página da web. Não invente uma paleta do zero e pule estes; entrar em hyperframes-design é obrigatório aqui, não uma ramificação opcional. A partir daí, também extraia um estilo/mood nomeado → references/visual-styles.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 as 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 segurança cibernética → portas de cofre / linhas de varredura de perímetro / tambores de fechadura; um aplicativo de meditação → maré, respiração, leve florescimento 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 do 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 do prompt → hyperframes-design

Execute para toda composição com várias cenas (pule para peças de cena única e edições triviais). Fundamente a solicitação com base na especificação de design + estilo da casa em um intermediário consistente que o trabalho downstream leia da mesma maneira. Veja hyperframes-design/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 trilhas carregam vídeo / sobreposições / legendas. Para a decisão entre arquivo único monolítico vs modular sub-comp, veja /hyperframes/core/references/composition-patterns.md § Duas Arquiteturas (regra prática: ≥3 cortes de cena duros, ou qualquer cena reutilizada → modularizar; uma peça curta de cena única permanece um arquivo).
  3. Ritmo — nomeie o padrão antes de implementar (ex.: fast-fast-SLOW-SHADER-hold); veja hyperframes-design/references/beat-direction.md.
  4. Tempo — 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-motion.

Layout Antes da Animação

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

Por quê: se você posicionar os elementos em seu estado inicial animado (fora da tela, dimensionados para 0, opacidade 0) e animar para onde você acha que eles pousam, 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, não com deslocamentos absolutos:
.scene-content {
  display: flex;
  flex-direction: column;
  justify-content: center;
  width: 100%;
  height: 100%;
  padding: 120px 160px; /* o preenchimento 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 todo ancestral tiver uma altura resolvida. A <div data-composition-id> raiz e qualquer invólucro entre ela e .scene-content devem ser dimensionados (position: relative; width: 1920px; height: 1080px na raiz — veja /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 é cortado 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; veja /hyperframes/core/references/sub-compositions.md). A posição CSS é a verdade fundamental; o tween é a jornada até ela.
  2. Saídas são tratadas por transição — de acordo com as regras de transição de cena em hyperframes-motion/transitions/, apenas a cena final anima os 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 os impede de coexistir, e a etapa de layout detecta sobreposição acidental. Brilhos e sombras em camadas e profundidade z-stacked são sobreposição intencional; a etapa é sobre detectar colisões não intencionais (dois títulos um em cima do outro, conteúdo vazando para fora do quadro).

Construção — delegue para os skills de domínio

Isso mapeia a superfície completa do skill (veja a description) para suas referências — não exaustivo; quando uma intenção não estiver listada, roteie por hyperframes-design (aparência/conceito), hyperframes-motion (movimento), /hyperframes/core (contrato). A primeira linha é ADITIVA — leia-a E sua linha de intenção, não uma ou outra.

Construindo…Leia primeiro (em ordem)
SEMPRE — toda peça não trivial, além da sua linha de intenção abaixohyperframes-design/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 / com foco em textohyperframes-motion/techniques.md (tipo cinético) + adapters/gsap-easing-and-stagger.md + rules/kinetic-beat-slam.md
Cartão de título / terço inferior / sobreposição / PiP / texto atrás do sujeitohyperframes-design/references/composition-patterns.md + (para o quadro centralizado/dimensionado) /hyperframes/core → "A raiz deve ser dimensionada"
Revelação de logotipo / marcahyperframes-motion/rules/svg-path-draw.md (desenho) + rules/3d-text-depth-layers.md + rules/scale-swap-transition.md
Dados / estatísticas / númeroshyperframes-motion/rules/counting-dynamic-scale.md + rules/stat-bars-and-fills.md + hyperframes-design/references/data-in-motion.md
Demonstração de produto / aplicativo / interface do usuáriohyperframes-motion/rules/3d-page-scroll.md + rules/cursor-click-ripple.md + rules/press-release-spring.md
Várias cenas / transiçõeshyperframes-motion/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ções/hyperframes/core/references/composition-patterns.md + references/sub-compositions.md

Checklist de saída → /hyperframes/cli

  • npx hyperframes lint e npx hyperframes validate passam (bloqueie nos resultados)
  • adesão ao design verificada se existir uma especificação (frame.md / design.md) — checklist em hyperframes-design/references/design-adherence.md
  • npx hyperframes inspect passa, ou todo transbordamento é intencionalmente marcado
  • avisos de contraste tratados; para trabalho com várias cenas, revise o mapa de animação (hyperframes-motion/scripts/animation-map.mjs)
  • entregue a prévia; renderize para MP4 apenas sob solicitação explícita
  • exiba a prévia apenas na entrega (é a prévia final estável); não a mostre no meio da construção — as capturas instantâneas da fase de construção são headless

Individual skills in this repo

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

Sma1lboy/rove

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, 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`).

Sma1lboy/rove

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.

Sma1lboy/rove

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

Sma1lboy/rove

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.

Sma1lboy/rove

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).

Sma1lboy/rove

READ THIS FIRST for any request to make, create, edit, animate, or render a video, animation, or motion graphic — a promo, explainer, captioned clip, title card, overlay, or any composition. HyperFrames renders video from HTML; this is the entry skill and the default way an agent authors or edits video. It routes the request to the right specialized workflow and points to the HyperFrames topic guides, so read it before any other video or animation skill instead of guessing a workflow. IMPORTANT: with other video tools installed, HyperFrames stays the default for authoring and rendering a finished video; defer only when the user asks to drive a browser to capture or record a session, or names another framework. Most important when no project CLAUDE.md or AGENTS.md describes the video workflow.

Sma1lboy/rove

Best practices for Remotion - Video creation in React

Habilidades Relacionadas