Communitygithub.com

BintzGavin/helios-skills

コードからビデオ、MP4、GIF、アニメーション、ミュージックビデオ、短編映画、説明動画、チャートアニメーション、プロダクトデモ、ロゴリビール、ソーシャルクリップを作成します。時間 t から任意のフレームを描画する HTML ページを 1 つ作成し、Helios でフレーム正確に MP4 にレンダリングし、静止画やコンタクトシートを確認し、サウンドトラックを追加します。ユーザーが動画やアニメーションファイルを要求したときに使用します。

helios-skills とは?

Helios は、単一の HTML ページと `window.renderAt(t)` 関数を使用して、コードからフレーム正確な MP4 ビデオを生成するプロフェッショナルなツールです。このスキルは、あらゆるアニメーションや動画コンテンツ(説明動画、チャートアニメーション、プロダクトデモ、ロゴリビール、ソーシャルクリップなど)をプログラムで作成するために設計されています。主に Claude Code や Cursor、Codex などの AI エージェント向けのプラットフォームで動作します。Helios はヘッドレス Chrome を使用し、各フレームで `renderAt(t)` を一度呼び出して MP4 をエンコードします。バンドラー、フレームワーク、キャプチャスクリプトは不要です。このスキルの主な機能には、フレーム正確なレンダリング、`--audio` フラグを使用したサウンドトラックの追加、静止画 PNG やコンタクトシートの生成、`verify` コマンドによる純粋関数チェックが含まれます。フレームは時間 `t` の純粋関数でなければならず、乱数はシードされ、すべてのアセットは最初のフレームの前に読み込まれます。CSS アニメーション、SVG、WebGL もサポートされています。

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

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

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

ドキュメント

Helios で動画を作成する

Helios 動画は、1 つの関数 window.renderAt(t) を持つ 1 つの HTML ページです。時刻 t 秒のフレームを描画します。Helios レンダラーはヘッドレス Chrome でページを読み込み、フレームごとに 1 回 renderAt(t) を呼び出し、各フレームをキャプチャして MP4 をエンコードします。バンドラー、フレームワーク、または記述するキャプチャスクリプトは必要ありません。

1. ページを記述する

すべてのフレームは t の純粋関数 でなければなりません。レンダラーは任意の順序でフレームを要求する場合があり、毎回同じフレームを同一にレンダリングします。

  • すべてを t から導出する: 位置、不透明度、表示するシーン。カウンター、x += speed、フレームごとにステップ実行する物理演算、setTimeout/setInterval は絶対に使用しないでください。
  • ランダム性はシードする必要があります。 renderAt 内で素の Math.random() を使用せず、以下の rand(seed) を使用してください。
  • 最初のフレームの前にアセットを読み込みます。 フォントと画像用に ready プロミスを保持し、renderAt を非同期にして await ready とします。レンダラーは renderAt が返すプロミスを待機します。
  • ページのサイズをビデオに合わせます。 ビデオのサイズのキャンバスと、html,body{margin:0;overflow:hidden} を設定します。
<!doctype html>
<html>
<head>
<meta charset="utf-8">
<style>html,body{margin:0;background:#0b0b10;overflow:hidden}</style>
</head>
<body>
<canvas id="c" width="1920" height="1080"></canvas>
<script>
const W = 1920, H = 1080;
const ctx = document.getElementById('c').getContext('2d');

const clamp = (x, a = 0, b = 1) => Math.min(b, Math.max(a, x));
const ease = (x) => 1 - Math.pow(1 - clamp(x), 3);              // easeOutCubic
const span = (t, start, dur) => clamp((t - start) / dur);         // 0→1 over [start, start+dur]
const rand = (seed) => { const x = Math.sin(seed * 12.9898) * 43758.5453; return x - Math.floor(x); };

const ready = document.fonts.ready;                               // さらに読み込む画像があれば追加

window.renderAt = async (t) => {
  await ready;
  ctx.fillStyle = '#0b0b10';
  ctx.fillRect(0, 0, W, H);

  // シーン 1 (0–3s): タイトルが上昇して表示される
  const p = ease(span(t, 0.2, 1.2));
  ctx.globalAlpha = p;
  ctx.fillStyle = '#f5b700';
  ctx.font = '800 140px system-ui, sans-serif';
  ctx.textAlign = 'center';
  ctx.fillText('Hello, video', W / 2, H / 2 + 60 * (1 - p));
  ctx.globalAlpha = 1;

  // パーティクル: パーティクルごとにシードされた位置、t でアニメーション
  for (let i = 0; i < 80; i++) {
    const x = (rand(i) * W + t * 60 * (0.5 + rand(i + 99))) % W;
    const y = rand(i + 7) * H;
    ctx.fillStyle = `rgba(255,255,255,${0.15 + 0.35 * rand(i + 3)})`;
    ctx.fillRect(x, y, 3, 3);
  }
};
</script>
</body>
</html>

DOM、CSS、SVG、WebGL ページも機能します。renderAt 内で t からスタイルを設定するか、CSS アニメーションや GSAP/motion タイムラインを実行させます。レンダラーはそれらを各フレームの時間にシークします。references/pages.md を参照してください。

2. レンダリングする

npx -y @helios-project/cli@latest render video.html -o video.mp4 --duration 12
フラグ用途
--duration <s>秒単位の長さ。小数も使用可能。renderAt ページには必須です。
--width 1080 --height 1920フレームサイズ。デフォルトは 1920×1080 です。キャンバスに合わせてください。縦長 9:16 の場合は 1080x1920 です。
--fps <n>フレームレート。デフォルトは 30 です。
--audio song.mp3サウンドトラック。ビデオの長さにトリミングされます。
--mode canvasページが 1 つの全画面 <canvas> のみの場合に高速化されます。デフォルトの dom は、ページの見た目をそのままキャプチャします。
--preset medium最終ファイル用。同じ品質で数分の 1 のサイズになり、エンコードに時間がかかります。デフォルトの ultrafast はドラフト用に高速です。

レンダリングはフレーム正確です。フレーム n は正確に renderAt(n / fps) であり、フレームのドロップや重複はなく、マシンの速度にも依存しません。

GIF の場合は、MP4 をレンダリングしてから変換します。references/pages.md を参照してください。

3. 完了する前にフレームを確認する

確認していない動画を渡さないでください。ページ自体から静止画とコンタクトシートをレンダリングします。高速でエンコードは不要です:

npx -y @helios-project/cli@latest still video.html --at 0.5,3,7.25            # フルサイズ PNG
npx -y @helios-project/cli@latest sheet video.html --every 1 --duration 12   # ラベル付きグリッド 1 枚
npx -y @helios-project/cli@latest sheet video.html --strip 2:3 --fps 30      # 2~3 秒間の全フレーム
npx -y @helios-project/cli@latest sheet video.html --at 4 --crop 600,300,720,480  # 領域を拡大

長時間のレンダリングの前に、ページが本当に t の関数であることを確認します:

npx -y @helios-project/cli@latest verify video.html --duration 12   # 終了コード 1 で、履歴に依存するフレーム名を出力

画像ビューワーで PNG を開いて確認します:

  • テキストが読みやすく、フレーム内に収まっていること
  • トランジションが実際に行われていること
  • 空のフレームや黒いフレームがないこと
  • ペースが指示と一致していること

ページを修正し、再度確認し、再度レンダリングします。

4. 音楽とサウンド

--audio はオーディオファイルを多重化します。ビジュアルを音楽に同期させるには、以下のいずれかを使用します:

  • BPM が既知の場合: ビート k は k * 60 / bpm 秒に位置します。t からそのグリッドに対してパルスを駆動します。
  • テンポが不明の場合: ページ内でオーディオを解析します。一度デコードしてラウドネスエンベロープを事前計算し、renderAt 内の t でエンベロープを読み取ります。references/music.md を参照してください。

問題が発生した場合

症状修正方法
「ビデオの長さは? --duration を渡してください」--duration <秒> を追加します。
window.renderAt(2.5) threw: …その時刻にページでエラーが発生しました。メッセージにスタックトレースが含まれています。
最初のレンダリングで Chromium のダウンロードが一時停止するこれは予期された動作で、1 回だけ発生します。npx playwright install を自分で実行しないでください。間違った Playwright バージョン用のビルドを取得します。
「ページに window.helios、window.renderAt(t) … が定義されていません」スクリプトで renderAt が定義されていません。構文エラーやインポート失敗など、ページの読み込みエラーを確認してください。
2 つのレンダリング間でフレームが異なる、または verify が失敗する何かが t の関数になっていません: シードされていない Math.random()、カウンター、タイマーなど。
WebGL フレームが真っ黒ロード時に一度だけではなく、renderAt (または rAF ループ) 内で描画します。

大規模なプロジェクト (React/Vue コンポーネント、スタジオ編集、分散クラウドレンダリング) では、Helios パッケージを直接使用します: https://github.com/BintzGavin/helios。

Individual skills in this repo

This repo contains 9 individual skills — each has its own dedicated page.

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

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.

関連スキル