Communitygithub.com

BintzGavin/helios-skills

Muster für die Verwendung von Helios mit GSAP (GreenSock). Verwende es, wenn du GSAP-Timelines mit der Helios-Timeline integrieren möchtest, um präzises Scrubbing und Rendering zu ermöglichen.

Was ist helios-skills?

Diese Fertigkeit beschreibt Muster zur Integration von GSAP-Animationen mit Helios, einer timeline-basierten Rendering-Engine. GSAP-Timelines müssen mit `paused: true` initialisiert werden, damit sie nicht automatisch mit Helios um die Steuerung der Animation kämpfen. Helios treibt die Synchronisation über seinen `subscribe`-Callback an, der Frames in Sekunden umrechnet und dann `tl.seek(seconds)` aufruft, um die GSAP-Animation zu einem exakten Zeitpunkt zu positionieren. Die Fertigkeit unterstützt browserbasierte Projekte, die GSAP und Helios verwenden, und warnt vor der Verwendung von `requestAnimationFrame` oder `tl.progress()` ohne normalisierte Werte. Sie ist ideal für Entwickler, die präzise, scrubbare Animationen in interaktiven Erlebnissen oder Preview-Umgebungen erstellen möchten.

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

GSAP-Integrationsmuster

Um GSAP mit Helios zu verwenden, musst du die GSAP-Timeline-Instanz mit dem Helios-Frame-Zustand steuern. So können GSAP-Animationen durchsucht (gescrubbt), pausiert und frame-genau gerendert werden.

Schnellstart

Das „Pausierte Timeline“-Muster

  1. Erstelle eine GSAP-Timeline mit paused: true.
  2. Abonniere die Helios-Updates.
  3. Konvertiere innerhalb des Abonnements den Helios-Frame in Sekunden.
  4. Rufe timeline.seek(seconds) zur Synchronisation auf.
<script type="module">
  import { Helios } from '@helios-project/core';
  import { gsap } from 'gsap';

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

  // 2. GSAP-Timeline einrichten (PAUSED ist entscheidend)
  const tl = gsap.timeline({ paused: true });

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

  // 4. Abonnieren und synchronisieren
  helios.subscribe((state) => {
    // Frame-Anzahl in Sekunden umrechnen
    const timeInSeconds = state.currentFrame / helios.fps;

    // GSAP zur exakten Zeit bringen
    tl.seek(timeInSeconds);
  });

  // 5. Für die Vorschau binden
  helios.bindToDocumentTimeline();
  window.helios = helios;
</script>

Kritische Regeln

  1. Immer pausieren: Die GSAP-Timeline muss mit { paused: true } initialisiert werden. Wenn sie automatisch abläuft, konkurriert sie mit Helios um die Kontrolle.
  2. seek verwenden: Verwende nicht tl.progress(), es sei denn, du berechnest den normalisierten Wert zwischen 0 und 1. tl.seek(seconds) ist in der Regel direkter, da Helios FPS und Frame-Anzahl kennt.
  3. Kein requestAnimationFrame: Erstelle keine eigene rAF-Schleife für GSAP. Lass Helios die Updates über subscribe steuern.

Quelldateien

  • Beispiel: 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.

Verwandte Skills