Communitygithub.com

BintzGavin/helios-skills

Helios와 Framer Motion을 함께 사용할 때 필요한 패턴입니다. Framer Motion의 물리엔진과 전환 효과를 사용하면서 Helios와의 프레임 단위 동기화가 필요할 때 사용하세요.

helios-skills란 무엇인가요?

이 스킬은 Helios(프레임 기반, 스크러빙 가능한 시스템)와 Framer Motion(시간 기반 애니메이션 라이브러리)을 통합하는 방법을 제공합니다. 핵심은 Helios의 프레임 상태를 Framer Motion의 MotionValue에 매핑하여 동기화하는 것입니다. `useVideoFrame` 훅을 사용하여 현재 프레임을 가져오고, `useTransform`을 사용하여 이를 애니메이션 값(예: 회전, 불투명도)으로 변환합니다. 또한 심층 컴포넌트 트리에서 성능을 최적화하기 위해 MotionValue를 직접 구독(subscription)하여 업데이트하는 고급 패턴도 포함되어 있습니다. React 환경에서 사용되며, Framer Motion의 다양한 애니메이션 기능을 Helios와 함께 정밀하게 제어하고자 하는 개발자에게 유용합니다.

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

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Framer Motion 통합

Framer Motion 애니메이션은 일반적으로 시간 기반입니다. 이를 Helios(프레임 기반이며 스크러빙 가능)와 동기화하려면 Helios 프레임 상태를 MotionValue에 매핑해야 합니다.

빠른 시작

1. useVideoFrame 훅

useVideoFrame 훅이 있는지 확인하세요(examples/react/SKILL.md 참조).

2. 프레임을 MotionValue에 매핑

useTransform을 사용하여 현재 프레임(useVideoFrame에서 가져옴)을 애니메이션 값으로 매핑합니다.

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

export const MyComponent = ({ helios }) => {
  // 1. 현재 프레임 가져오기
  const frame = useVideoFrame(helios);

  // 2. 프레임을 위한 MotionValue 생성
  const frameMv = useMotionValue(0);

  // 프레임이 변경될 때마다 MotionValue 동기화
  useEffect(() => {
    frameMv.set(frame);
  }, [frame, frameMv]);

  // 3. 프레임 -> 애니메이션 값 변환
  // 예시: 60프레임(0~60) 동안 360도 회전
  const rotate = useTransform(frameMv, [0, 60], [0, 360]);

  // 예시: 처음 30프레임 동안 불투명도 페이드 인
  const opacity = useTransform(frameMv, [0, 30], [0, 1]);

  return (
    <motion.div
      style={{
        width: 100,
        height: 100,
        background: 'blue',
        rotate,   // 변환된 값 바인딩
        opacity
      }}
    />
  );
};

고급: 수동 MotionValue 설정

깊은 트리에서 더 나은 성능을 위해 구독(subscription) 내에서 직접 공유 MotionValue를 업데이트하여 React 상태를 우회합니다.

const frameMv = useMotionValue(0);

useEffect(() => {
  const unsubscribe = helios.subscribe((state) => {
    // 직접 MotionValue 업데이트 - React 리렌더링 없음!
    frameMv.set(state.currentFrame);
  });
  return unsubscribe;
}, [helios, frameMv]);

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

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

소스 파일

  • 예시: 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.

관련 스킬