Communitygithub.com

BintzGavin/helios-skills

Patrones para usar Helios con GSAP (GreenSock). Útil al integrar líneas de tiempo de GSAP con la línea de tiempo de Helios para un control preciso frame por frame.

¿Qué es helios-skills?

Esta skill proporciona patrones de integración para usar GSAP (GreenSock) con Helios, un framework de animación basado en frames. Su propósito es permitir que las animaciones de GSAP sean controladas, pausadas y renderizadas frame por frame mediante la línea de tiempo de Helios, en lugar de ejecutarse de forma independiente. La skill se enfoca en el patrón "Paused Timeline", donde la línea de tiempo de GSAP se inicializa en pausa y se sincroniza con los frames de Helios usando `tl.seek()`. Es compatible con proyectos que usan Helios y GSAP en entornos web modernos, y ofrece ejemplos claros y reglas críticas para evitar conflictos de control entre ambos sistemas. El repositorio incluye un ejemplo práctico en la carpeta `examples/gsap-animation/`.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/BintzGavin/helios-skills/tree/HEAD/skills/examples/gsap

Preguntar en tu IA favorita

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

Documentación

Patrones de Integración con GSAP

Para usar GSAP con Helios, debes controlar la instancia de la línea de tiempo de GSAP utilizando el estado de frame de Helios. Esto permite que las animaciones de GSAP se desplacen, pausen y rendericen frame por frame.

Inicio Rápido

El Patrón "Línea de Tiempo Pausada"

  1. Crea una línea de tiempo de GSAP con paused: true.
  2. Suscríbete a las actualizaciones de Helios.
  3. Dentro de la suscripción, convierte el frame de Helios a segundos.
  4. Llama a timeline.seek(segundos) para sincronizar.
<script type="module">
  import { Helios } from '@helios-project/core';
  import { gsap } from 'gsap';

  // 1. Inicializar Helios
  const helios = new Helios({
    fps: 30,
    durationInSeconds: 5,
  });

  // 2. Configurar la línea de tiempo de GSAP (PAUSADO es crítico)
  const tl = gsap.timeline({ paused: true });

  // 3. Definir animaciones
  tl.to(".box", {
    rotation: 360,
    x: 100,
    duration: 2,
    ease: "power1.inOut"
  })
  .to(".box", {
    scale: 2,
    duration: 2
  });

  // 4. Suscribirse y sincronizar
  helios.subscribe((state) => {
    // Convertir el número de frame a segundos
    const timeInSeconds = state.currentFrame / helios.fps;

    // Llevar GSAP al tiempo exacto
    tl.seek(timeInSeconds);
  });

  // 5. Vincular para vista previa
  helios.bindToDocumentTimeline();
  window.helios = helios;
</script>

Reglas Críticas

  1. Siempre Pausar: La línea de tiempo de GSAP debe inicializarse con { paused: true }. Si se reproduce automáticamente, entrará en conflicto con Helios por el control.
  2. Usar Seek: No uses tl.progress() a menos que calcules el valor normalizado 0-1. tl.seek(segundos) suele ser más directo ya que Helios conoce el FPS y el número de frames.
  3. Sin requestAnimationFrame: No crees tu propio bucle rAF para GSAP. Deja que Helios maneje las actualizaciones mediante subscribe.

Archivos Fuente

  • Ejemplo: examples/gsap-animation/

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

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

Motion design framework for programmatic video. Defines anti-slideshow architecture, visual layering, physics-based easing, choreography rules, and quality validation. Reference this skill from any guided video skill.

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