Communitygithub.com

BintzGavin/helios-skills

Helios와 GSAP(GreenSock)을 통합하기 위한 패턴입니다. GSAP 타임라인을 Helios 타임라인과 정확히 연동하여 스크러빙과 렌더링을 수행할 때 사용합니다.

helios-skills란 무엇인가요?

이 스킬은 GSAP(GreenSock) 애니메이션 라이브러리와 Helios 타임라인 시스템을 통합하는 방법을 제공합니다. Helios의 프레임 상태를 기반으로 GSAP 타임라인을 구동하여 애니메이션을 스크러빙, 일시 중지, 프레임 단위로 렌더링할 수 있습니다. 주요 패턴은 '일시 중지된 타임라인'으로, GSAP 타임라인을 `paused: true`로 초기화하고 Helios의 업데이트를 구독하여 프레임을 초 단위로 변환한 후 `timeline.seek(seconds)`로 동기화합니다. 이 접근법은 GSAP이 자체적으로 재생되지 않도록 하여 Helios와의 충돌을 방지하며, `requestAnimationFrame` 루프 없이 Helios의 구독 메커니즘을 통해 정밀한 제어를 가능하게 합니다. 이 스킬은 웹 개발자와 애니메이션 전문가가 Helios 기반 인터랙티브 콘텐츠에 GSAP의 고급 애니메이션 기능을 통합할 때 유용합니다.

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

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

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

문서

GSAP 통합 패턴

GSAP을 Helios와 함께 사용하려면 Helios 프레임 상태를 이용하여 GSAP 타임라인 인스턴스를 구동해야 합니다. 이렇게 하면 GSAP 애니메이션을 스크러빙, 일시 중지, 프레임 단위로 렌더링할 수 있습니다.

빠른 시작

"일시 중지된 타임라인" 패턴

  1. paused: true로 GSAP 타임라인을 생성합니다.
  2. Helios 업데이트를 구독합니다.
  3. 구독 내에서 Helios 프레임을 초 단위로 변환합니다.
  4. timeline.seek(seconds)를 호출하여 동기화합니다.
<script type="module">
  import { Helios } from '@helios-project/core';
  import { gsap } from 'gsap';

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

  // 2. GSAP 타임라인 설정 (PAUSED 상태가 중요)
  const tl = gsap.timeline({ paused: true });

  // 3. 애니메이션 정의
  tl.to(".box", {
    rotation: 360,
    x: 100,
    duration: 2,
    ease: "power1.inOut"
  })
  .to(".box", {
    scale: 2,
    duration: 2
  });

  // 4. 구독 및 동기화
  helios.subscribe((state) => {
    // 프레임 수를 초 단위로 변환
    const timeInSeconds = state.currentFrame / helios.fps;

    // GSAP을 정확한 시간으로 이동
    tl.seek(timeInSeconds);
  });

  // 5. 미리보기 바인딩
  helios.bindToDocumentTimeline();
  window.helios = helios;
</script>

중요 규칙

  1. 항상 일시 중지: GSAP 타임라인은 { paused: true }로 초기화해야 합니다. 자동으로 재생되면 Helios와 제어권을 두고 충돌합니다.
  2. Seek 사용: 정규화된 0-1 값을 계산하지 않는 한 tl.progress()를 사용하지 마십시오. Helios가 FPS와 프레임 수를 알고 있으므로 tl.seek(seconds)가 일반적으로 더 직접적입니다.
  3. requestAnimationFrame 금지: GSAP를 위한 자체 rAF 루프를 생성하지 마십시오. subscribe를 통해 Helios가 업데이트를 주도하도록 하십시오.

소스 파일

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

관련 스킬