Communitygithub.com

HyperFrames Core

HyperFrames 合成契約 — 単一のレンダリング可能なプロジェクトを構築します。合成構造、`data-*` タイミング属性、`class="clip"`、トラック、サブ合成、変数、フレームワーク所有のメディア再生、決定論的レンダリングルール、および検証に使用します。作曲HTMLを書く前に読んでください。

HyperFrames Core とは?

HyperFrames Core スキルは、HyperFrames フレームワークでビデオ合成(動画プロジェクト)を構築するための技術的契約を定義します。HTML、CSS、JavaScript(主に GSAP)を使用して、タイムライン駆動型の動画をレンダリングする方法を規定し、`data-*` 属性によるタイミング宣言、`class="clip"` によるクリップ構造、サブ合成のネスト、変数管理、フレームワークが所有するメディア再生(`<video>`、`<audio>`)を統一的に扱うためのルールを提供します。このスキルは、Claude Code、Cursor、Codex などの AI エージェントが、HyperFrames プロジェクトの作成、編集、検証を行うための主要なガイドとして機能し、`hyperframes-animation`、`hyperframes-creative`、`hyperframes-cli` などの関連スキルと連携して、アニメーションランタイム、クリエイティブディレクション、CLI 操作をカバーします。決定論的レンダリングを重視し、`Math.random`、ネットワークアクセス、無限ループなどを禁止することで、シーク可能で再現性のあるタイムラインを保証します。また、`npx hyperframes check` コマンドで静的解析(lint)を実行し、`gsap_css_transform_conflict` や `media_crossorigin_breaks_preview` などの一般的な落とし穴を事前に検出します。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Zuhair-01/claude-skills-and-systems/tree/HEAD/skills/hyperframes-core

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

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

ドキュメント

HyperFrames Core は何をしますか?

エージェント向け注意点(最初にお読みください):

  • flex/inset で中央揃えにし、CSS transform: translate(-50%,-50%) を使用しないでください。GSAP で x/y をアニメーションするノードに対して使用すると競合します。Lint メッセージ: gsap_css_transform_conflict。代わりに fromTo または xPercent/yPercent を使用してください。
  • シーン終了時に tl.set(..., {visibility:"hidden"}) を追加しないでください。ランタイムはすでにタイミング設定されたクリップを非表示にします。内部ノード(または .clip の opacity)での透明度フェードで十分です。キャプションの強制終了は別ルールです。
  • window.__timelines["id"] はルートの data-composition-id と一致する必要があります。
  • render 後、サマリーの 2 行目を読んでください:beginframe vs screenshot、GPU モード、ステージタイミング。screenshot + Linux の software gpu は低速パスです。

HyperFrames は HTML からビデオをレンダリングします。コンポジションとは、data-* 属性でタイミングを宣言し、アニメーションランタイムがシーク可能で、メディア再生がフレームワークに所有される HTML ファイルです。

このスキルは 技術的契約 です — 1 つの hyperframes プロジェクトを構築する方法。以下の本文はビルドガイドです。トピックごとの詳細は references/(次にインデックスを参照)にあり、必要に応じて参照してください。プロセスドキュメント(ブリーフ、ストーリーボード、レビュー、制作、ディスパッチ、フレームワーカー)は /hyperframes → references/ にあります。その他の懸念事項は、兄弟ドメインスキル(hyperframes-animation、hyperframes-creative、media-use、hyperframes-cli、hyperframes-registry)にあります。機能マップは /hyperframes で各スキルのカバー範囲を示しています。

リファレンス

ファイルこれにより…
references/minimal-composition.md最も小さなレンダリング可能なコンポジションスケルトンから始める
references/composition-patterns.mdモノリシック vs モジュラーを選択する;モジュラー index.html を構造化する;サブコンポジションのアーキタイプを選ぶ
references/data-attributes.md任意の data-*(ルート / クリップ / サブコンポジションホスト / レガシーエイリアス)を調べる;class="clip" を使用する
references/tracks-and-clips.mddata-track-index が制御する(およびしない)内容、z-index、別のクリップに対する相対タイミングを理解する;npx hyperframes timeline ですべてのトラックとクリップを一覧表示する
references/creator-editing-recipes.md正しいカット/トリム/並べ替え/リタイム/フリーズ/カメラ/マスク/クロスフェード/オーディオ編集レシピとその制限をコピーする
references/sub-compositions.mdサブコンポジション(ホスト属性、<template>、インスタンスごとの変数)を配線し、その内部でアニメーションさせる
references/variables-and-media.md変数を宣言する;<video>/<audio> を配置し、音量を設定し、トリムする
references/determinism-rules.mdシーク可能なタイムラインを構築する;決定論の禁止事項;レイアウト / テキストフィット
references/full-screen-motion.md共有背景を使用して全画面モーションを作成する
references/tailwind.mdTailwind v4 プロジェクトで作業する(init --tailwind;ランタイム契約は Studio の v3 とは異なります)

アニメーションランタイム固有の詳細(GSAP API、Lottie、Three.js など)については、hyperframes-animation → adapters/<runtime>.md を参照してください。

コンポジションの構築

2 つのルートフォーム(互換性なし)

  • スタンドアロン(トップレベル index.html):ルート <div data-composition-id="…"> は <body> 内に直接配置され、<template> ラッパーは不要。スタンドアロンルートをラップするとすべてのコンテンツが非表示になり、lint はそれを拒否します(standalone_composition_wrapped_in_template、エラー)。
  • サブコンポジション(data-composition-src 経由でロード):ルートを <template> でラップします。これが記述すべき形状です:ローダーはプレーンな完全ドキュメントも受け入れ、その <body> にフォールバックしますが、テンプレート化された形式が例やツールが想定するものです。

⚠ 転送ルール:テンプレート化された サブコンポジションの場合、アセンブラはファイル自身の <head> 内の <style>/<script> を削除します(packages/core/src/compiler/compositionAssembly.ts、hasTemplate ゲート)。そのため、<style>/<script> はテンプレート 内側 に配置してください。<link> はどちらの場合でもホイストされます。 ⚠ ホスト ID の規則:ホストスロット、内部テンプレート、window.__timelines["<id>"] キーに 同じ ID を付与してください。異なるローカル ID もサポートされています(アセンブラはファイル内の最初のルートにフォールバックします)が、不一致はサイレントに発生するため、特別な理由がない限り一致させてください。

ファイル形状、ホスト配線、およびレンダリング前のチェックリスト → references/sub-compositions.md。

ルートはサイズ指定が必要(サイレントレイアウトバグ)

スタンドアロンルートは width/height: 100% を使用します。キャンバスサイズは data-width/data-height です。ランタイムはそれらのピクセルをコンポジションルートに適用します。#root に 1920px/1080px をハードコードしないでください。スケルトン → references/minimal-composition.md。

1 つの一時停止タイムライン

各コンポジションは 正確に 1 つ の gsap.timeline({ paused: true }) を window.__timelines["<id>"](キー = ルート data-composition-id)に登録します。非同期コールバック(document.fonts.ready)内で構築することもサポートされています。重要なのは、ビルド完了後にのみ登録する ことです。レンダリング長さはルートの data-duration であり、タイムラインの長さ ではありません:タイムラインがそれを超えるとカットされ、早期に終了する場合は最後のフレームを保持します。ルートの data-duration を省略すると、長さは代わりに推論されます(タイムライン、メディアウィンドウ、またはアダプター)。window.__timelines = window.__timelines || {} は不要です:ランタイムはインラインスクリプトが実行される前にレジストリを作成し、lint はそれを要求しなくなりました。サブタイムラインをホストに手動でネストしないでください;ランタイムは登録された子タイムラインを自動的にネストします。完全な契約(GSAP 以外のランタイムを含む)→ references/determinism-rules.md + hyperframes-animation/adapters/。

初回 lint の落とし穴(確実な初回ビルド失敗)

lint が 確かに キャッチするルールですが、事後的にのみです。最初から正しく記述してください:

  • CSS の初期 transform と 同じ プロパティに対する GSAP トゥイーンを決して組み合わせないでください — CSS 値とトゥイーンの開始値が競合し、lint は gsap_css_transform_conflict で拒否します。CSS transform: translateX(-40px) の代わりに、トゥイーン内で gsap.fromTo(el, { x: -40 }, { x: 0 }) を使用して初期状態を設定してください。
  • <video>/<audio> に crossorigin を決して付けないでください。lint は media_crossorigin_breaks_preview(エラー)で無条件に拒否します。canvas/WebGL/WebAudio の読み戻しも含みます。抑制方法はありません。
  • data-start を持つ <video> に、同じく data-start を持つ祖先要素を決して与えないでください。lint は video_nested_in_timed_element(エラー)で拒否します。ラッパー または ビデオのどちらか一方にタイミングを設定し、両方には設定しないでください。
  • すべての <audio> には id が必要です。lint は media_missing_id で拒否し、id のない <audio> はミキサーに認識されないため、レンダリングは 無音 になります。
  • .clip を autoAlpha または visibility でトゥイーンしないでください — lint は gsap_animates_clip_element で拒否します。代わりに子要素をアニメーションさせてください。
  • 名前付き CSS font-family には、出荷されたローカルファイルへの @font-face がファイル内にある必要があります。そうしないと、lint は font_family_without_font_face を発行します。
  • サブコンポジション #root はハードコードされた 1920px/1080px ではなく、width/height: 100%(または inset: 0)を使用します。キャンバスサイズは data-width/data-height です。

lint エラー はレイアウトとコントラスト監査もオフにします:check はその後 0 sample(s) と 0/0 text checks を報告します。これはクリーンファイルのように見えますが、何も実行されなかったことを意味します。lint エラーをクリアしてから、それらの数値を信頼してください。

不可侵ルール(自動ゲートが見逃す可能性のあるサイレントバグ)

ここに提示します;完全な論理的根拠はリンクされたリファレンスにあります。違反しないでください:

  • レンダリング時間のクロック / シードされていない Math.random / ネットワーク / 入力状態は禁止;repeat: -1 は使用禁止(有限回数を使用)。→ determinism-rules.md
  • .clip 要素の display、visibility、または autoAlpha を決してトゥイーンしないでください。フレームワークがクリップの可視性を所有し、lint はそれを拒否します(gsap_animates_clip_element)。代わりに子要素をアニメーションさせてください。→ determinism-rules.md
  • 本文テキストに <br> は不使用;変換された要素はブロックレベル + サイズ指定が必要;パルスする絶対配置デコレーションにはピーククリアランスが必要。→ determinism-rules.md
  • <video>/<audio> はフラットなドキュメントクエリで検出されるため、フレームワークは 任意のネスト深さ(サブコンポジション <template> またはラッパー内も含む)でそれらをシークおよびデコードします。1 つのハード制限:lint は、data-start を持つ <video> が同じく data-start を持つ別の プレーン 要素内にある場合にエラーとし、その失敗は現実のものになります(間違ったソースフレームが取得され、クリップがスロット途中で消えます)。そのため、タイミングはラッパーかビデオのどちらか一方に設定し、両方には決して設定しないでください。サブコンポジションホストは対象外です:サブコンポジション内のメディアは正しくレンダリングされます。もう 1 つの注意点は配置ではなくタイムラインです:サブコンポジションのタイムラインはホストルート要素をアニメーションできません。→ variables-and-media.md
  • すべての id を アセンブルされた ページ全体で一意に保ってください(サブコンポジションの id にはコンポジション id をプレフィックスとして付け、#<id>-hero の形式にします)。これにより、独自の #id CSS および getElementById 呼び出しが解決されます。フレームインジェクションはこれに依存しなくなりました:コンパイラはすべての video[src]/audio[src]/img[src] にドキュメント一意の data-hf-render-id をスタンプします。src 属性の代わりに <source> 子要素を使用するメディアはスタンプ されない ため、そこでは一意の id が依然として重要です。→ composition-patterns.md
  • コンポジション ルート の全画面塗りつぶしは、通常のレンダリングでは問題ありません。レイヤードコンポジットパス(HDR コンテンツ、またはシェーダートランジションを使用するコンポジション)でのみ削除されます。その場合、エンジンはすべてのコンポジションルートを透明に強制し、下のレイヤーが見えるようにします。コンポジションがシェーダートランジションまたは HDR メディアを使用する場合は、塗りつぶしを全幅の 子要素(position:absolute; inset:0)に配置してください。→ composition-patterns.md

既存のコンポジションの編集

  • 最初にファイルを読んでください。関連のないタイミング、トラック、ID、変数、メディアパスは保持してください。
  • プロジェクトのタイムライン上にあるもの(トラック、クリップ、開始、終了、再生内容)を確認するには、index.html とすべてのサブコンポジションファイルを読む代わりに、npx hyperframes timeline [--json] を実行してください。
  • 既存のコンポジション ID とタイムラインキーに一致させてください。
  • クリップを追加する:その data-start/data-duration を、周囲のクリップに対して意図的に設定してください。data-track-index は Studio の表示レーンであり、タイミングの制約ではないため、空いている必要はありません。
  • コンポジション要素の data-hidden は、プレビューとレンダリングの 両方 で非表示にし、その時間ウィンドウをオーバーライドします。これは非破壊的/可逆的であり、Studio のタイムラインの目のアイコンで切り替えられます。
  • サブコンポジションを追加する:ホストを配線する前に、内部の data-composition-id を確認してください。

検証

コマンドの詳細については hyperframes-cli を使用してください

  • npx hyperframes check がパスする(lint、ランタイム、レイアウト、モーション、コントラストにわたって 0 件の検出)
  • サブコンポジションを含むプロジェクト:npx hyperframes snapshot --at <midpoints> を実行し、各フレームを目視確認する
  • レビュー用に npx hyperframes preview --background(ユーザーは Studio のタイムラインで任意の要素を編集でき、サーバーは呼び出しコマンド後も存続します)
  • ユーザーが承認した後にのみ npx hyperframes render を実行する

Individual skills in this repo

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

Zuhair-01/claude-skills-and-systems

Create AI avatar videos with precise control over avatars, voices, scripts, scenes, and backgrounds using HeyGen's v2 API. Use when: (1) Choosing a specific avatar and voice for a video, (2) Writing exact scripts for an avatar to speak, (3) Building multi-scene videos with different backgrounds per scene, (4) Creating transparent WebM videos for compositing, (5) Using talking photos as video presenters, (6) Integrating HeyGen avatars with Remotion, (7) Batch video generation with exact specs, (8) Brand-consistent production videos with precise control.

Zuhair-01/claude-skills-and-systems

Generate Mandarin and multilingual narration with Volcengine Doubao Speech 2.0. Use when creating Chinese voiceovers, when the user prefers Doubao/Volcengine/火山引擎/豆包 TTS, or when narration needs character-level timestamp metadata for subtitles.

Zuhair-01/claude-skills-and-systems

Edit existing videos using AI — remix style, upscale, remove background, and add audio via fal.ai's hosted video models.

Zuhair-01/claude-skills-and-systems

Video and audio processing with FFmpeg. Use for format conversion, resizing, compression, audio extraction, and preparing assets for Remotion. Triggers include converting GIF to MP4, resizing video, extracting audio, compressing files, or any media transformation task.

Zuhair-01/claude-skills-and-systems

Author or edit a custom HyperFrames composition when no specialized workflow fits, or when BRIEF.md sets flow: companion. Use for longer or multi-scene pieces, brand and sizzle reels, montages, static loops, static title cards, footage remixes, and freeform builds. Use motion-graphics instead for a short unnarrated motion-first unit, including an animated title. Route fresh creation through hyperframes before using this skill.

Zuhair-01/claude-skills-and-systems

Read-only queue dashboard for workspace-aware ship. (gstack)

Zuhair-01/claude-skills-and-systems

Generate HeyGen presenter videos via the v3 Video Agent pipeline — handles Frame Check (aspect ratio correction), prompt engineering, avatar resolution, and voice selection. Required for any HeyGen video generation. Replaces deprecated endpoints with v3. Use when: (1) generating any HeyGen video (via API or otherwise), (2) sending a personalized video message (outreach, update, announcement, pitch, knowledge), (3) creating a HeyGen presenter-led explainer, tutorial, or product demo with a human face, (4) "make a video of me saying...", "send a video to my leads", "record an update for my team", "create a video pitch", "make a loom-style message", "I want to appear in this video", "generate a HeyGen video", "make a talking head video". Accepts avatar_id from heygen-avatar for identity-first HeyGen videos, or uses a stock presenter. Returns video share URL + HeyGen session URL for iteration. Chain signal: when the user wants to create/design an avatar AND make a video in the same request, run heygen-avatar f...

Zuhair-01/claude-skills-and-systems

All animation knowledge for HyperFrames — atomic motion rules, multi-phase scene blueprints, scene transitions, broader motion-design techniques, AND the seven runtime adapters (GSAP default, plus Lottie, Three.js, Anime.js, CSS keyframes, Web Animations API, TypeGPU). Use for any motion or animation task: pick 2-4 rules and compose, or load a blueprint, or look up runtime-specific API (e.g. GSAP eases / Lottie player / Three.js mixer). Also covers auditing an existing composition's choreography (animation map) and 24 named text-animation effects. HyperFrames-native: single paused timeline, seek-safe, deterministic.

Zuhair-01/claude-skills-and-systems

Generates high-converting Next.js/React landing pages with Tailwind CSS. Uses PAS, AIDA, and BAB frameworks for optimized copy/components (Heroes, Features, Pricing). Focuses on Core Web Vitals/SEO.

関連スキル