Communitygithub.com

BintzGavin/helios-skills

Helios と GSAP (GreenSock) を連携するためのパターン。Helios のタイムラインと GSAP のタイムラインを統合し、正確なスクラブとレンダリングを実現します。

helios-skills とは?

このスキルは、Helios のフレームベースのタイムラインと GSAP のアニメーションタイムラインを同期させるための統合パターンを提供します。主な機能として、GSAP のタイムラインを一時停止状態で初期化し、Helios の subscribe メソッドを使用してフレーム更新を秒数に変換し、`tl.seek(seconds)` で GSAP アニメーションを正確に制御します。これにより、アニメーションのスクラブ、一時停止、フレーム単位のレンダリングが可能になります。対応プラットフォームは Helios と GSAP を使用するあらゆる環境であり、特にインタラクティブなタイムライン制御が必要な Web アニメーションに有用です。スキルは HTML と JavaScript のサンプルコードを含み、開発者がすぐに実装できるよう設計されています。

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

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

GSAP 統合パターン

Helios で GSAP を使用するには、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. シークを使用する: 正規化された 0~1 の値を計算しない限り、tl.progress() は使用しないでください。tl.seek(seconds) の方が、Helios が FPS とフレーム数を認識しているため、通常はより直接的です。
  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.

関連スキル