Communitygithub.com

BintzGavin/helios-skills

Framework de design de movimento para vídeos programáticos. Define arquitetura anti-slideshow, camadas visuais, easing baseado em física, regras de coreografia e validação de qualidade. Referencie esta skill a partir de qualquer skill de vídeo guiado.

O que é helios-skills?

O Helios é um framework de design de movimento para criar vídeos programáticos que evitam a aparência de slideshow. Ele impõe uma arquitetura anti-slideshow, onde elementos globais (fundo, partículas, logo) permanecem contínuos entre cenas, enquanto elementos locais (texto, estatísticas, imagens) são específicos de cada cena. A composição visual deve ter no mínimo 4 camadas (Vácuo, Textura, Contexto e Herói), garantindo profundidade e evitando achatamento. O framework também define uma personalidade única de easing baseada na identidade da marca (ex: circOut para tech, easeInOut para luxo) e regras de coreografia com atrasos escalonados (stagger) para entradas e saídas sobrepostas. Além disso, inclui o "teste do apertar os olhos" para validar hierarquia e espaço negativo, e regras de continuidade de transição que evitam cortes secos. O Helios é ideal para desenvolvedores e criadores que usam motion.dev ou WAAPI, e pode ser referenciado por outras skills de vídeo guiado para garantir consistência e qualidade profissional.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/BintzGavin/helios-skills/tree/HEAD/skills/guided/motion-design-rules

Perguntar na sua IA favorita

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

Documentação

Estas regras se aplicam a toda composição de vídeo Helios. Leia e internalize-as antes de produzir uma especificação criativa ou escrever código de composição.


REGRIA 1 — Arquitetura Anti-Slideshow

O maior erro em vídeo baseado em código é construir um PowerPoint (Cena A desaparece → Cena B aparece).

A câmera nunca para.

Separe todos os elementos em duas categorias:

Elementos GLOBAIS persistem entre as cenas: • Textura ou gradiente de fundo • Partículas flutuantes, orbes ou formas de destaque • Logotipo ou marca • Movimento ambiente (deriva lenta, pulsação sutil)

Elementos LOCAIS são específicos da cena: • Texto principal daquela cena • Detalhes de apoio, estatísticas ou chamadas • Imagens específicas da cena

Elementos globais NÃO devem ser reiniciados entre as cenas. Eles se transformam, deslocam ou evoluem — mas nunca desaparecem e reaparecem.

Isso cria a ilusão de um único mundo contínuo em vez de uma sequência de slides separados.


REGRIA 2 — A Pilha Visual (Mínimo de 4 Camadas)

Cada quadro deve ter pelo menos 4 camadas de profundidade. Uma composição plana parece amadora.

Camada 0 — O Vácuo Cor base ou gradiente profundo. Nunca preto puro a menos que seja intencional.

Camada 1 — A Textura Ruído sutil, deriva de gradiente, linhas de grade ou vídeo de movimento lento. Esta camada nunca é estática. Sempre respira.

Camada 2 — O Contexto Formas flutuantes, linhas, elementos de UI de destaque ou partículas. Elas ficam atrás do conteúdo principal, mas na frente do fundo. Movem-se mais devagar que os elementos do primeiro plano (parallax).

Camada 3 — O Herói Conteúdo principal: texto, imagens, UI do produto. Maior contraste. Bordas mais nítidas. Atrai o olhar imediatamente.

Se um quadro tiver menos de 3 camadas visíveis, adicione profundidade.


REGRIA 3 — Motor de Física (Easing Global)

Defina UMA personalidade de easing global para o vídeo inteiro. Toda animação deve usar este easing, a menos que haja um motivo criativo específico para quebrar a regra.

Combine o easing com a identidade da marca:

• Tech / Desenvolvedor / Hacker → circOut (início rápido, parada brusca) • Luxo / Spa / Premium → easeInOut (início lento, fim lento) • Lúdico / Consumidor / Diversão → spring (ultrapassa e oscila) • Corporativo / Empresarial → easeOut (desaceleração controlada) • Ousado / Startup / Energia → backOut (leve ultrapassagem, confiante)

Defina isso na especificação criativa como:

physics: { easing: "circOut", defaultDuration: 0.4 }

Todas as animações motion.dev / WAAPI devem referenciar esta constante.


REGRIA 4 — Coreografia e Escalonamento

Nada aparece de uma vez.

A ordem de entrada para cada cena:

  1. O fundo se desloca ou evolui (prepara o cenário)
  2. Elementos de contexto animam (linhas, formas, destaques)
  3. Texto principal entra escalonado (palavra por palavra ou linha por linha)
  4. Detalhes de apoio em cascata (um por um, não simultaneamente)

O atraso de escalonamento entre elementos filhos deve ser de 50ms–150ms, dependendo do nível de energia.

Alta energia (promo, social): atraso de 50–80ms Energia média (demo, lançamento): atraso de 80–120ms Baixa energia (explicativo, depoimento): atraso de 100–150ms

As animações de saída devem se sobrepor à entrada da próxima cena por pelo menos 200ms. As cenas devem fazer crossfade, não troca.


REGRIA 5 — O Teste do Apertar os Olhos

Antes de finalizar a composição, pause em 5 quadros aleatórios e "aperte os olhos" mentalmente para o layout.

Verifique:

• Você consegue identificar instantaneamente o elemento mais importante? (Hierarquia) • Há espaço negativo suficiente? (Espaço para respirar) • Existem mais de 3 pontos focais concorrentes? (Desordem — remova algo) • Cada elemento visível tem um propósito? (Nenhuma decoração por decoração)

Se algum quadro falhar no teste, simplifique. Espaço é um elemento de design, não apenas pixels vazios.


REGRIA 6 — Continuidade de Transição

As transições de cena nunca devem ser um corte seco seguido de silêncio.

Durante cada transição:

• Pelo menos um elemento global deve ser visualmente contínuo • A saída da cena anterior e a entrada da cena seguinte devem se sobrepor • A energia do áudio (se houver) deve fazer a ponte da transição • As mudanças de paleta de cores devem ser graduais, não abruptas

Padrões de transição preferidos:

• Wipe com fundo persistente • Saída com escala do herói → entrada com escala do novo herói (metáfora de câmera) • Deslize direcional (o conteúdo se move como se a câmera estivesse panorâmica) • Formas que se transformam e carregam energia entre as cenas

Evite: cortes secos, lacunas pretas completas, fade-out/fade-in simultâneos.

Individual skills in this repo

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

BintzGavin/helios-skills

Make a video, MP4, GIF, animation, music video, short film, explainer, chart animation, product demo, logo reveal or social clip from code. Write one HTML page that draws any frame from its time t, render it frame-exact to MP4 with Helios, check stills and contact sheets, and add a soundtrack. Use whenever the user asks for a video or an animation file.

BintzGavin/helios-skills

>- Story-first motion design philosophy for animated video: motion must earn its place; arc (establish, complicate, resolve); show vs tell; shots as units of thought; quiet vs loud motion; Disney principles with restraint; timing heuristics; composition; grammar by medium (product demos, logos, data viz, explainers); technical commitments (deterministic time, scrubbability, refs); cutting discipline; explicit anti-patterns. Use when planning, storyboarding, critiquing, or implementing programmatic or motion-driven video (Helios, Remotion, explainers, loops, UI capture, logo reveals), or when the user asks for motion direction, pacing, or visual-story structure.

BintzGavin/helios-skills

>- End-to-end production plan template for feeling-first cinematic product promos: brief interrogation, 45s beat structure (cold open through brand), hero-element metaphor, storyboard fidelity ladder, visual system (palette, type, camera, texture), motion mix and easing vocabulary, audio and captions, tooling (animatic through HTML or AE), deliverables matrix, accessibility, review milestones, and compromises to accept or refuse. Use when planning, pitching, storyboarding, or producing polished brand films for any SaaS or consumer product—not category-specific; pair with skills/design/animated-video-philosophy for broader motion principles.

BintzGavin/helios-skills

Patterns for using Helios with Framer Motion. Use when you want to use Framer Motion's physics and transitions but need frame-perfect synchronization with Helios.

BintzGavin/helios-skills

Patterns for using Helios with GSAP (GreenSock). Use when integrating GSAP timelines with the Helios timeline for precise scrubbing and rendering.

BintzGavin/helios-skills

End-to-end guided workflow for creating an explainer or walkthrough video. Extracts brand identity from the repo, generates a measured soundtrack, and produces a narrative-driven motion.dev composition rendered via Helios CLI. Use when making how-it-works, feature walkthrough, or educational videos.

BintzGavin/helios-skills

End-to-end guided workflow for creating a promotional hype video. Extracts brand identity from the repo, generates beat-synced music, and produces a high-energy motion.dev composition rendered via Helios CLI. Use when making brand-aligned promo or hype videos.

BintzGavin/helios-skills

End-to-end guided workflow for creating a social proof or testimonial video. Extracts brand identity from the repo, generates a warm soundtrack, and produces a trust-building motion.dev composition rendered via Helios CLI. Use when making customer testimonial, review highlight, or social proof videos.

BintzGavin/helios-skills

Workflow for rendering a Helios composition to a video file. Use when you need to automate video production or export a high-quality animation.

Habilidades Relacionadas