Communitygithub.com

BintzGavin/helios-skills

Modèles pour utiliser Helios avec GSAP (GreenSock). À utiliser lors de l'intégration des timelines GSAP avec la timeline Helios pour un contrôle précis et un rendu image par image.

Qu'est-ce que helios-skills ?

Ce skill fournit des modèles essentiels pour intégrer GSAP (GreenSock) avec Helios, permettant aux animations GSAP d'être contrôlées image par image via la boucle de rendu d'Helios. Il résout le problème fondamental de synchronisation en imposant que la timeline GSAP soit mise en pause (`paused: true`) et pilotée via la méthode `seek()` à partir des images d'Helios. Cette approche permet aux développeurs de bénéficier de la puissance expressive de GSAP pour des animations complexes (rotations, déplacements, échelles) tout en profitant du système de timeline unifié d'Helios pour le scrubbing (recherche), la pause et le rendu précis. Le skill est conçu pour être utilisé avec les agents IA comme Claude Code ou Cursor, et le code fourni est compatible avec les environnements JavaScript standards (ES modules), Helios Core et GSAP. Il insiste sur les règles critiques : ne jamais utiliser `requestAnimationFrame` personnalisé, ne pas laisser la timeline GSAP jouer automatiquement, et toujours utiliser `tl.seek(secondes)` pour synchroniser.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Modèles d'intégration GSAP

Pour utiliser GSAP avec Helios, vous devez piloter l'instance GSAP Timeline en utilisant l'état d'image d'Helios. Cela permet aux animations GSAP d'être contrôlées, mises en pause et rendues image par image.

Démarrage rapide

Le modèle "Timeline en pause"

  1. Créez une timeline GSAP avec paused: true.
  2. Abonnez-vous aux mises à jour d'Helios.
  3. Dans l'abonnement, convertissez l'image Helios en secondes.
  4. Appelez timeline.seek(seconds) pour synchroniser.
<script type="module">
  import { Helios } from '@helios-project/core';
  import { gsap } from 'gsap';

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

  // 2. Configuration de la timeline GSAP (PAUSED est essentiel)
  const tl = gsap.timeline({ paused: true });

  // 3. Définition des animations
  tl.to(".box", {
    rotation: 360,
    x: 100,
    duration: 2,
    ease: "power1.inOut"
  })
  .to(".box", {
    scale: 2,
    duration: 2
  });

  // 4. Abonnement et synchronisation
  helios.subscribe((state) => {
    // Conversion du nombre d'images en secondes
    const timeInSeconds = state.currentFrame / helios.fps;

    // Recherche GSAP à l'instant exact
    tl.seek(timeInSeconds);
  });

  // 5. Liaison pour la prévisualisation
  helios.bindToDocumentTimeline();
  window.helios = helios;
</script>

Règles critiques

  1. Toujours mettre en pause : La timeline GSAP doit être initialisée avec { paused: true }. Si elle joue automatiquement, elle entrera en conflit avec Helios pour le contrôle.
  2. Utiliser Seek : N'utilisez pas tl.progress() sauf si vous calculez la valeur normalisée 0-1. tl.seek(seconds) est généralement plus direct car Helios connaît le FPS et le nombre d'images.
  3. Pas de requestAnimationFrame : Ne créez pas votre propre boucle rAF pour GSAP. Laissez Helios piloter les mises à jour via subscribe.

Fichiers sources

  • Exemple : 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 associés