Communitygithub.com

BintzGavin/helios-skills

Marco de diseño de movimiento para video programático. Define arquitectura anti-diapositivas, capas visuales, suavizado basado en física, reglas de coreografía y validación de calidad. Consulta esta skill desde cualquier skill de video guiado.

¿Qué es helios-skills?

Esta skill proporciona un conjunto completo de reglas de composición de video y diseño de movimiento para la creación de videos programáticos con Helios. Está diseñada para guiar a desarrolladores, diseñadores de movimiento y agentes de IA en la producción de videos que eviten la apariencia de una presentación de diapositivas tradicional, garantizando una experiencia visual fluida, cinematográfica y de alta calidad. La skill define seis reglas fundamentales: una arquitectura anti-diapositivas que mantiene elementos globales persistentes entre escenas; un apilamiento visual mínimo de 4 capas (Fondo, Textura, Contexto y Héroe); un sistema de suavizado global basado en física que se alinea con la identidad de marca; reglas de coreografía y escalonamiento para entradas y salidas de elementos; la 'prueba del entrecerrar ojos' para validar jerarquía y claridad visual; y reglas de continuidad de transición para evitar cortes bruscos. Es compatible con cualquier plataforma que implemente Helios y motion.dev, y es referenciada por otras skills de video guiado. Al internalizar estas reglas, un agente de IA puede generar especificaciones creativas y código de composición coherentes, asegurando que el video resultante tenga profundidad, ritmo y una sensación de mundo continuo.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Estas reglas se aplican a toda composición de video Helios. Léelas e interiorízalas antes de producir una especificación creativa o escribir código de composición.


REGLAS 1 — Arquitectura Anti-Diapositivas

El mayor error en el video basado en código es construir un PowerPoint (Escena A se desvanece → Escena B aparece).

La cámara nunca se detiene.

Separa todos los elementos en dos categorías:

Los elementos GLOBALES persisten entre escenas: • Textura o gradiente de fondo • Partículas flotantes, orbes o formas de acento • Logotipo o marca • Movimiento ambiental (deriva lenta, pulso sutil)

Los elementos LOCALES son específicos de la escena: • Texto principal de esa escena • Detalles de apoyo, estadísticas o llamadas • Imágenes específicas de la escena

Los elementos globales NO deben reiniciarse entre escenas. Se transforman, desplazan o evolucionan, pero nunca desaparecen y reaparecen.

Esto crea la ilusión de un mundo continuo único en lugar de una secuencia de diapositivas separadas.


REGLA 2 — La Pila Visual (Mínimo 4 Capas)

Cada fotograma debe tener al menos 4 capas de profundidad. Una composición plana se ve amateur.

Capa 0 — El Vacío Color base o gradiente profundo. Nunca negro puro a menos que sea intencional.

Capa 1 — La Textura Ruido sutil, deriva de gradiente, líneas de cuadrícula o video de movimiento lento. Esta capa nunca es estática. Siempre respira.

Capa 2 — El Contexto Formas flotantes, líneas, elementos de acento de UI o partículas. Estos se sitúan detrás del contenido principal pero delante del fondo. Se mueven más lento que los elementos del primer plano (paralaje).

Capa 3 — El Héroe Contenido principal: texto, imágenes, UI del producto. Mayor contraste. Bordes más nítidos. Atrae la mirada de inmediato.

Si un fotograma tiene menos de 3 capas visibles, agrega profundidad.


REGLA 3 — Motor de Física (Suavizado Global)

Define UNA personalidad de suavizado global para todo el video. Cada animación debe usar este suavizado a menos que haya una razón creativa específica para romper la regla.

Haz coincidir el suavizado con la identidad de la marca:

• Tecnología / Desarrollador / Hacker → circOut (inicio rápido, frenada fuerte) • Lujo / Spa / Premium → easeInOut (inicio lento, final lento) • Juguetón / Consumidor / Diversión → spring (sobreimpulso y bamboleo) • Corporativo / Empresarial → easeOut (deceleración controlada) • Audaz / Startup / Energía → backOut (ligero sobreimpulso, confiado)

Define esto en la especificación creativa como:

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

Todas las animaciones de motion.dev / WAAPI deben hacer referencia a esta constante.


REGLA 4 — Coreografía y Escalonamiento

Nada aparece todo a la vez.

El orden de entrada para cada escena:

  1. El fondo se desplaza o evoluciona (prepara el escenario)
  2. Los elementos de contexto se animan (líneas, formas, acentos)
  3. El texto principal aparece escalonadamente (palabra por palabra o línea por línea)
  4. Los detalles de apoyo caen en cascada (uno por uno, no simultáneamente)

El retardo de escalonamiento entre elementos secundarios debe ser de 50 ms a 150 ms dependiendo del nivel de energía.

Alta energía (promo, social): 50–80 ms de escalonamiento Energía media (demo, lanzamiento): 80–120 ms de escalonamiento Baja energía (explicativo, testimonial): 100–150 ms de escalonamiento

Las animaciones de salida deben superponerse con la entrada de la siguiente escena en al menos 200 ms. Las escenas deben fundirse, no intercambiarse.


REGLA 5 — La Prueba del Entrecerrar Ojos

Antes de finalizar la composición, pausa en 5 fotogramas aleatorios y "entrecerrar" mentalmente los ojos en el diseño.

Verifica:

• ¿Puedes identificar instantáneamente el elemento más importante? (Jerarquía) • ¿Hay suficiente espacio negativo? (Respiración) • ¿Hay más de 3 puntos focales en competencia? (Desorden — elimina algo) • ¿Cada elemento visible tiene un propósito? (Sin decoración por decoración)

Si algún fotograma falla la prueba del entrecerrar ojos, simplifica. El espacio es un elemento de diseño, no solo píxeles vacíos.


REGLA 6 — Continuidad de Transición

Las transiciones entre escenas nunca deben ser un corte brusco seguido de silencio.

Durante cada transición:

• Al menos un elemento global debe ser visualmente continuo • La salida de la escena que termina y la entrada de la escena que comienza deben superponerse • La energía de audio (si está presente) debe tender un puente sobre la transición • Los cambios de paleta de colores deben ser graduales, no abruptos

Patrones de transición preferidos:

• Barrido con fondo persistente • Escalar y desaparecer héroe → escalar y aparecer nuevo héroe (metáfora de cámara) • Deslizamiento direccional (el contenido se mueve como si la cámara estuviera paneando) • Formas que se transforman y llevan energía entre escenas

Evita: cortes bruscos, espacios negros completos, desvanecimiento y aparición 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.

Skills relacionados