Communitygithub.com

Aseel1600/Edit01

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

Edit01 とは?

このスキルはHyperFramesフレームワークの中心的な技術契約を定義します。HyperFramesはHTMLからビデオをレンダリングし、コンポジションは`data-*`属性でタイミングを宣言するDOMを持つHTMLファイルであり、アニメーションランタイムはシーク可能で、メディア再生はフレームワークが所有します。このスキルは、スタンドアロンまたはサブコンポジションとしてのプロジェクト構築方法、ルート要素のサイジング、`window.__timelines`への正確に1つの一時停止タイムラインの登録、決定論的レンダリングのための不可侵ルール(ランタイムクロックの禁止、`repeat: -1`の禁止、許可されたアニメート可能プロパティのみの使用)について詳細に説明しています。また、`lint`、`validate`、`inspect`、`snapshot`、`preview`、`render`などのCLIコマンドを使用したバリデーション手順もカバーしており、すべての参照ファイルの包括的なリストを提供しています。これは、Claude Codeや同様のAIエージェントツールでHyperFramesコンポジションを作成または編集する開発者に不可欠であり、レンダリングのバグを防ぎ、シーク可能で決定論的な出力を保証します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Aseel1600/Edit01/tree/HEAD/.agents/skills/hyperframes-core

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

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

ドキュメント

HyperFrames コア

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

このスキルは 技術契約 — 1つの hyperframes プロジェクトを構築する方法です。以下の本文はビルドガイドです;トピックごとの詳細は references/(次にインデックス)にあり、必要に応じて読んでください。その他の関心事は、姉妹ドメインスキル — hyperframes-animation、hyperframes-creative、hyperframes-media、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 を処理し、クリップを別のクリップに対して相対的に時間設定する
references/sub-compositions.mdサブコンポジション(ホスト属性、<template>、インスタンスごとの変数)を配線し、その内部でアニメーションさせる
references/variables-and-media.md変数を宣言する;<video>/<audio> を配置し、ボリュームを設定し、トリミングする
references/determinism-rules.mdシーク可能なタイムラインを構築する;決定論の禁止事項;アニメーション可能プロパティの許可リスト;レイアウト / テキストフィット
references/full-screen-motion.md共有背景を使用して全フレームモーションを作成する
references/storyboard-format.mdSTORYBOARD.md 計画(+ 解析されたマニフェスト)を作成する
references/script-format.mdオプションの SCRIPT.md 固定ナレーションを作成する
references/subagent-dispatch.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> ラッパーは不要です(ラップするとすべてのコンテンツが非表示になり、レンダリングが壊れます)。
  • サブコンポジション(data-composition-src を介して読み込まれる) — ルートは <template> でラップする必要があります。

⚠ 転送ルール: ランタイムは <template> の内容のみをクローンします;それ以外(<head> のスタイル/スクリプトを含む)はすべて破棄されます — <style>/<script> はテンプレート 内側 に配置してください。 ⚠ ホストIDルール: ホストスロットの data-composition-id は、内部テンプレートの data-composition-id および window.__timelines["<id>"] キーと 完全に一致する必要があります — -mount/-slot/-host サフィックスは付けないでください。

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

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

スタンドアロンルートには、明示的な サイズ指定されたボックス(width/height を px で)が必要であり、height:100% 要素までのすべての祖先は、解決された高さを持っている必要があります — そうでないと、flex/100% の子要素は ~0 に collapse し、コンテンツが左上隅に寄ってしまいます。lint/validate/inspect はこれを 検出しません。スケルトン → references/minimal-composition.md。

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

各コンポジションは、ページロード時に 同期的に 構築された、window.__timelines["<id>"](キー = ルート data-composition-id)に 正確に1つ の gsap.timeline({ paused: true }) を登録します。レンダリング期間 = ルート data-duration(タイムラインの長さではありません)。サブタイムラインを手動でホストにネストしないでください。完全な契約(非GSAPランタイムを含む) → references/determinism-rules.md + hyperframes-animation/adapters/。

不可侵ルール(lint/validate/inspect が検出しないサイレントバグ)

ここに提示します;完全な根拠はリンクされた参照にあります。違反しないでください:

  • レンダリング時のクロック / シードされていない Math.random / ネットワーク / 入力状態は禁止;repeat: -1 は禁止(有限カウントを使用)。→ determinism-rules.md
  • 視覚プロパティの許可リストのみをアニメーション化;display/visibility は決して使用しない;後続シーンのクリップに gsap.set を使用しない。→ determinism-rules.md
  • 本文テキストに <br> は禁止;変換される要素はブロックレベル + サイズ指定が必要;脈動する絶対配置の装飾要素はピーククリアランスが必要。→ determinism-rules.md
  • <video>/<audio> はホストルートの 直接の子 である必要があります(サブコンポジションの <template>/ラッパーの内側には絶対に配置しない);フレームワークが再生を所有します。→ variables-and-media.md
  • すべての id は、組み立てられた ページ全体で一意である必要があります;サブコンポジション内では、id にコンポジション id をプレフィックスとして付けます(#<id>-hero)。重複する <video>/<img> id は 空白 でレンダリングされます — プロデューサーは getElementById でフレームを注入し、ファイル間の重複は lint をすり抜けます。→ composition-patterns.md
  • 全画面シーンフィルは、全画面表示の 子(position:absolute; inset:0)に配置し、コンポジションルート自体には決して配置しないでください — プロデューサーのフレームコンポジットがルート要素自身の background をドロップする可能性があります(フレームは 黒 でレンダリングされます)。プレビュー/snapshot では正しく表示されていても同様です。→ composition-patterns.md

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

  • 最初にファイルを読んでください。無関係なタイミング、トラック、ID、変数、メディアパスは保持してください。
  • 既存のコンポジションIDとタイムラインキーを一致させてください。
  • クリップを追加する場合: 重複しない data-track-index を選択するか、意図的に周囲のタイミングを調整してください。
  • サブコンポジションを追加する場合: ホストを配線する前に、内部の data-composition-id を確認してください。

バリデーション

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

  • npx hyperframes lint がパスする(エラー0)
  • npx hyperframes validate がパスする(コンソールエラー0)
  • npx hyperframes inspect がパスする(エラー0)
  • サブコンポジションを含むプロジェクト: npx hyperframes snapshot --at <midpoints> を実行し、各フレームを目視確認する
  • レビュー用に npx hyperframes preview(ユーザーはStudioのタイムラインで何でも編集できます)
  • npx hyperframes render はユーザーが承認した後にのみ実行する

Individual skills in this repo

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

Aseel1600/Edit01

Generate AI videos from text prompts using multiple provider gateways. Use when: (1) Generating videos from text descriptions, (2) Creating AI-generated video clips for content production, (3) Image-to-video generation with a reference image, (4) Choosing between video generation providers (VEO, Kling, Sora, Runway, Seedance, MiniMax, Gemini Omni). Supports gateways: HeyGen API, fal.ai API, Kling official direct API, and the Gemini API (Gemini Omni Flash).

Aseel1600/Edit01

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.

Aseel1600/Edit01

Use p5.js/canvas for local procedural character effects: particles, weather, squash/stretch, walk cycles, and environmental motion.

Aseel1600/Edit01

Review local character animation with schema checks, Playwright browser previews, frame sampling, and FFmpeg/ffprobe final output checks.

Aseel1600/Edit01

Create videos from a text prompt using HeyGen's Video Agent. Use when: (1) Creating a video from a description or idea, (2) Generating explainer, demo, or marketing videos from a prompt, (3) Making a video without specifying exact avatars, voices, or scenes, (4) Quick video prototyping or drafts, (5) One-shot prompt-to-video generation, (6) User says "make me a video" or "create a video about X".

Aseel1600/Edit01

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.

Aseel1600/Edit01

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.

Aseel1600/Edit01

Generate expressive, multilingual narration with fish.audio (S1 / S2-generation models) and reuse cloned voices via reference_id. Use when the user prefers fish.audio/Fish Audio TTS, wants a specific playground voice model, or needs high-emotion voice-clone narration.

Aseel1600/Edit01

Use when implementing Disney's 12 animation principles with Framer Motion in React applications

Aseel1600/Edit01

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). HyperFrames-native: single paused timeline, seek-safe, deterministic.

Aseel1600/Edit01

HyperFrames CLI dev loop. Use when running npx hyperframes init, add, catalog, capture, lint, validate, inspect, layout, snapshot, preview, play, render, publish, lambda, doctor, browser, info, upgrade, skills, compositions, docs, benchmark, telemetry, transcribe, tts, or remove-background, or when troubleshooting the HyperFrames build/render environment. Entry point for AWS Lambda cloud rendering (`hyperframes lambda deploy / render / progress / destroy / policies`).

Aseel1600/Edit01

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`.

Aseel1600/Edit01

Audio and media assets for HyperFrames compositions, produced by one shared audio engine (`scripts/audio.mjs`) — multi-provider TTS (HeyGen / ElevenLabs / Kokoro local), background music + sound effects (HeyGen audio-library retrieval by default, with local Lyria / MusicGen BGM generation and a bundled SFX library as the no-credential fallback), Whisper transcription, background removal, and caption authoring. Use for voiceover / TTS, BGM, SFX / sound effects, transcription, captions / subtitles / lyrics / karaoke / per-word styling, voice + provider selection, and music-mood prompting.

Aseel1600/Edit01

Install and wire registry blocks and components into HyperFrames compositions. Use when running hyperframes add, installing a block or component, wiring an installed item into index.html, or working with hyperframes.json. Covers the add command, install locations, block sub-composition wiring, component snippet merging, registry discovery, and authoring a new block or component to contribute upstream (idea → scaffold → validate → PR).

Aseel1600/Edit01

Use when the user wants a short, design-led motion graphic where motion is the message: kinetic typography, stat or number count-up, chart/data-viz hit, logo sting, brand lockup, lower-third, callout, social overlay, animated headline/tweet/news item, motion poster, or quick captured-page highlight. Usually under 10s and up to ~30s, with no narration arc, voice-over, or live-action subject. Can render to MP4 or transparent overlay. Not for longer, multi-scene, narrated, or brand-reel pieces (use general-video), narrated website videos (website-to-video), topic explainers (faceless-explainer), product promos (product-launch-video), PR videos (pr-to-video), or captions on existing footage (embedded-captions). When unsure whether it's a quick motion-first piece or a longer / narrated treatment, see /hyperframes.

Aseel1600/Edit01

Use when the user has a music track (an audio file, or a video to pull audio from) and wants a beat-synced HyperFrames video, calm to hard-hitting. The music drives everything: one analyzer reads it once, the orchestrator lays out the frames and fills a per-frame plan, and one sub-agent builds each frame. Typography and templates are the floor — a complete video needs zero assets — but any images or videos the user supplies are cut into the frames on the same beat grid (beat-cut / ken-burns). The genre (lyric video, slideshow, kinetic promo) falls out of the per-frame choices; the pipeline never branches on it.

Aseel1600/Edit01

Best practices for Remotion - Video creation in React

Aseel1600/Edit01

Toolkit-specific Remotion patterns — custom transitions, shared components, and project conventions. For core Remotion framework knowledge (hooks, animations, rendering, etc.), see the `remotion-official` skill.

Aseel1600/Edit01

Port an existing Remotion (React) composition to HyperFrames HTML. Use ONLY when the user explicitly asks to port/convert/migrate/translate a Remotion source. Do NOT use: (a) authoring a new HyperFrames composition; (b) Remotion mentioned in passing; (c) Remotion code shared as reference only; (d) "same video as my Remotion one" without explicit migrate request — treat as fresh build. Doubt → `/general-video`. One-way, Remotion-only: no reverse export (HyperFrames→Remotion or any framework), no non-Remotion source (After Effects, Framer Motion, plain React/CSS) → out of scope, re-create via `/general-video`. Flags unsupported patterns (useState, useEffect, async calculateMetadata, third-party React libs, `@remotion/lambda`) and recommends runtime interop over lossy translation. Unsure whether to port vs. build fresh, or only a passing Remotion mention? → /hyperframes.

Aseel1600/Edit01

Animate SVG character rigs with GSAP, CSS transforms, Remotion frame control, and HyperFrames-compatible browser previews.

関連スキル