Communitygithub.com

BintzGavin/helios-skills

Muster für die Verwendung von Helios mit Framer Motion. Nutze Framer Motions Physik und Übergänge mit frame-genauer Synchronisation zu Helios.

Was ist helios-skills?

Diese Fähigkeit (Skill) beschreibt, wie du Framer Motion Animationen mit Helios synchronisieren kannst. Helios arbeitet frame-basiert und scrubbable, während Framer Motion typischerweise zeitbasiert ist. Der Skill zeigt dir, wie du den aktuellen Helios-Frame über den `useVideoFrame`-Hook ausliest und ihn mit `useTransform` auf Framer Motion `MotionValues` abbildest. Das ermöglicht es dir, Helios-getriebene, scrubbare Animationen mit der leistungsstarken Physik und den Übergängen von Framer Motion zu kombinieren. Der Skill enthält sowohl einen grundlegenden Quick-Start-Code, der `useVideoFrame` und `useTransform` nutzt, als auch eine fortgeschrittene Variante. Bei dieser wird das MotionValue direkt im Helios-Subscription-Callback aktualisiert, um React-Rerender zu vermeiden. Dies ist besonders nützlich für tiefe Komponentenbäume. Die Beispiele zeigen unter anderem Rotation und Opazität. Die Quellcodedateien befinden sich in `examples/framer-motion-animation/`. Unterstützt werden Frameworks wie React und die Bibliothek Framer Motion.

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

In Ihrer bevorzugten KI fragen

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

Dokumentation

Framer Motion Integration

Framer Motion Animationen sind normalerweise zeitbasiert. Um sie mit Helios (das frame-basiert und scrubbable ist) zu synchronisieren, musst du den Helios-Frame-Status auf MotionValues abbilden.

Schnellstart

1. useVideoFrame Hook

Stelle sicher, dass du den useVideoFrame-Hook hast (siehe examples/react/SKILL.md).

2. Frames auf MotionValues abbilden

Verwende useTransform, um den aktuellen Frame (von useVideoFrame) auf Animationswerte abzubilden.

import { useMotionValue, useTransform, motion } from 'framer-motion';
import { useVideoFrame } from './hooks/useVideoFrame';

export const MyComponent = ({ helios }) => {
  // 1. Aktuellen Frame abrufen
  const frame = useVideoFrame(helios);

  // 2. Ein MotionValue für den Frame erstellen
  const frameMv = useMotionValue(0);

  // MotionValue bei jeder Frame-Änderung synchronisieren
  useEffect(() => {
    frameMv.set(frame);
  }, [frame, frameMv]);

  // 3. Frame -> Animationswert transformieren
  // Beispiel: 360 Grad über 60 Frames drehen (0 bis 60)
  const rotate = useTransform(frameMv, [0, 60], [0, 360]);

  // Beispiel: Deckkraft über die ersten 30 Frames einblenden
  const opacity = useTransform(frameMv, [0, 30], [0, 1]);

  return (
    <motion.div
      style={{
        width: 100,
        height: 100,
        background: 'blue',
        rotate,   // Transformierten Wert binden
        opacity
      }}
    />
  );
};

Fortgeschritten: Manuelles Setzen des MotionValue

Für eine bessere Leistung in tiefen Komponentenbäumen kannst du ein gemeinsames MotionValue direkt im Subscription-Callback aktualisieren und so den React-Rerender umgehen.

const frameMv = useMotionValue(0);

useEffect(() => {
  const unsubscribe = helios.subscribe((state) => {
    // MotionValue direkt aktualisieren - kein React-Rerender!
    frameMv.set(state.currentFrame);
  });
  return unsubscribe;
}, [helios, frameMv]);

const x = useTransform(frameMv, [0, 100], [0, 500]);

return <motion.div style={{ x }} />;

Quelldateien

  • Beispiel: examples/framer-motion-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 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

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