Communitygithub.com

HyperFrames Core

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

HyperFrames Core とは?

このスキルは、HyperFrames フレームワークのコア合成契約を定義します。HyperFrames はHTMLからビデオをレンダリングし、DOM要素に `data-*` 属性を使用してタイミングを宣言することで、アニメーションランタイムをシーク可能にし、メディア再生をフレームワークが所有します。このスキルは、スタンドアロンとサブ合成の2つのルート形式、1つの一時停止タイムラインの登録、`npx hyperframes check` で検出されるリンターの問題(CSSとGSAPの競合、`crossorigin` メディア属性など)、および決定論的レンダリングの非交渉ルール(ランタイムクロック禁止、Math.random のシードなしなど)をカバーします。主に Claude Code、Cursor、Codex などのAIエージェントが HyperFrames プロジェクトを構築または編集する際に使用されます。

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

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

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

ドキュメント

プラグインインストール: セットアップやフレッシュネスコマンドの前に、このスキルが HyperFrames プラグイン内にある場合は プラグイン実行ルール に従ってください。スタンドアロンインストールは以下の更新手順を保持します。

HyperFrames Core は何をしますか?

エージェントの落とし穴(最初に読んでください):

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

HyperFrames はHTMLからビデオをレンダリングします。コンポジションは、data-* 属性でタイミングを宣言するDOMを持つ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.mddata-*(ルート / クリップ / サブコンポホスト / レガシーエイリアス)を検索。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つの一時停止タイムライン

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

初回パスリンターの注意点(最初のビルド失敗が保証されています)

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(エラー)で無条件に拒否します。キャンバス/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 です。

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

非交渉ルール(自動ゲートが見逃す可能性のある静的なバグ)

ここに表示されます。完全な根拠はリンク先のリファレンスにあります。違反しないでください。

  • レンダリング時のクロック/シードされていない Math.random/ネットワーク/入力状態は禁止。repeat: -1 は有限のルート data-duration の下でのみ許可(クリップをエクスポートしてそれに合わせる — それ以外の場合は有限カウントを使用)。→ determinism-rules.md
  • .clip 要素での display、visibility、または autoAlpha のトゥイーンは禁止。フレームワークがクリップの可視性を所有し、lint はそれを拒否します(gsap_animates_clip_element)。代わりに子をアニメーション化してください。→ determinism-rules.md
  • 本文テキストに <br> は禁止。変換された要素はブロックレベルでサイズ指定されている必要があります。パルスする絶対配置の装飾要素にはピーククリアランスが必要です。→ determinism-rules.md
  • <video>/<audio> はフラットなドキュメントクエリによって検出されるため、フレームワークは 任意のネスト深さ(サブコンポ <template> またはラッパー内も含む)でそれらをシークおよびデコードします。1つのハードリミット: data-start を持つ <video> が、同じく data-start を持つ別の プレーンな 要素の内側にある場合、lint はエラーを出します。そして、その失敗は実際のものです(間違ったソースフレーム、その後クリップがスロットの途中で消えます)。したがって、タイミングはラッパーまたはビデオのどちらかに設定し、両方には決して設定しないでください。サブコンポジションホストは免除されます。サブコンポジション内のメディアは正しくレンダリングされます。もう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-duration を超えて終了するクリップはカットオフされます。同じ編集でルート data-duration をクリップの終了まで延長してください(lint は clip_ends_past_root_duration を警告します)。
  • 任意のコンポジション要素の data-hidden は、プレビューとレンダリングの両方でそれを非表示にし、その時間ウィンドウをオーバーライドします。これは非破壊的/可逆的であり、Studioのタイムラインの目のアイコンで切り替えられます。
  • サブコンポジションを追加する: ホストを配線する前に、その内部の data-composition-id を確認してください。

検証

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

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

Individual skills in this repo

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

Elis3omndz/Claude_Skills

Add captions or subtitles to an existing single-subject talking-head video without editing the footage. Use for plain verbatim captions, cinematic captions embedded behind the subject, VFX captions, “炸/特效/酷炫字幕,” or a named identity from the 35-style catalog. Route by visual identity, not by backend engine. The quiet `anchor` rail is the default; embed every word only when the user explicitly wants a fully cinematic treatment. The workflow runs locally end to end, including transcription and subject matting; split multi-shot footage before applying it.

Elis3omndz/Claude_Skills

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.

Elis3omndz/Claude_Skills

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.

Elis3omndz/Claude_Skills

Use when audio already placed in a HyperFrames composition needs to be mixed: fade-in/fade-out, crossfade, track gain or volume, volume automation, ducking, a music bed that fights a voiceover (voiceover carve), effects on a track (EQ, compressor, limiter, gate, saturation, delay, reverb, chorus, phaser, bitcrush), automation envelopes drawn on a track's volume or any effect parameter, or one submix bus carrying a chain, a fader and an automation clock for several tracks at once (`<hf-audio-group>`). Don't use for sourcing or generating audio — finding BGM, SFX, or making a voiceover is `/media-use`. Don't use for clip timing or track layout, which is `/hyperframes-core`.

Elis3omndz/Claude_Skills

Non-animation creative direction for HyperFrames videos. Use for design spec (frame.md / design.md) handling, palettes, typography, narration, beat planning, audio-reactive visuals, composition patterns, and brand / style decisions. For atomic motion patterns and scene blueprints, use `hyperframes-animation`.

Elis3omndz/Claude_Skills

Use when a HyperFrames composition needs a punch-in, punch-out, zoom, reframe, Ken Burns treatment, camera move, visual match/whip handoff, or other seek-safe 2D/3D keyframes; also for GSAP, CSS keyframes, Anime.js, WAAPI, FLIP, paths, masks, SVG morph/draw, text trails, 3D depth, or `hyperframes keyframes` diagnostics. Don't use for broad scene strategy, brand design, media sourcing, captions, or general video planning.

Elis3omndz/Claude_Skills

Use when working with a person on a HyperFrames project in Studio: first, whether their message asks for a change at all (questions, loose ideas and "don't change anything" get an answer and a plan, not an edit); for a new film, the plan, storyboard and build order that the HyperFrames launch films follow; and how the timeline should be laid out so it reads well (one caption track, one element kind per track, every scene a sub-composition) and where captions and key content may sit (safe zones). Don't use for how to perform an individual edit (split, trim, retime, volume, copy, swap): that is `creator-editing-recipes.md` in `/hyperframes-core`.

Elis3omndz/Claude_Skills

A short, design-led motion graphic where motion is the message — kinetic typography, stat count-up, chart/data-viz hit, logo sting / brand lockup, lower-third / callout / social overlay, animated map (highlight regions, connect places, zoom to a location), animated tweet / news-article / headline, webpage / UI animation (scroll, cursor, callouts), or fusing a real image's geometry into a chart. Usually under 10s (up to ~30s), no narration or live-action subject; renders to MP4 or transparent overlay. Longer / narrated / multi-scene → /general-video. Unclear → /hyperframes.

Elis3omndz/Claude_Skills

Turn a music track (an audio file, a video to pull audio from, or a track generated from a mood brief) into a beat-synced video — lyric video, slideshow, or kinetic promo. The music drives all pacing; any user-supplied images/videos are cut onto the same beat grid, and a complete video needs zero assets. Narrated pieces → the input-matched workflow (see /hyperframes). Unclear → /hyperframes.

Elis3omndz/Claude_Skills

Turn a product or marketing URL, pasted script, or brief into a product launch / promo video — SaaS promos, feature reveals, product demos, app and company launches. Use when the user wants to market, launch, promote, or reveal a product; the default for any commercial URL. Site tours / showcases of a website route here too — the brief carries the show-it-as-is intent. Unclear → /hyperframes.

Elis3omndz/Claude_Skills

Turn a GitHub pull request (a PR URL, owner/repo#N, or 'this PR' in a checked-out repo) into a code-change explainer video — changelog, feature reveal, fix, or refactor walkthrough built from the diff, commits, and files: the input is a code change, not a website. Not a product promo (/product-launch-video) or a no-PR topic explainer (/faceless-explainer). Unclear → /hyperframes.

関連スキル