Communitygithub.com

Aseel1600/Edit01

HyperFrames CLI の開発ループ。`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`、または `remove-background` を実行する際、または HyperFrames のビルド/レンダリング環境のトラブルシューティングを行う際に使用します。AWS Lambda クラウドレンダリング(`hyperframes lambda deploy / render / progress / destroy / policies`)のエントリポイントです。

Edit01 とは?

このスキルは HyperFrames CLI の完全な開発ループを定義します。`npx hyperframes` を介して実行され、スキャフォールディング、作成、リンター、検証、プレビュー、レンダリングなどのすべての主要コマンドをカバーします。Node.js >= 22 と FFmpeg が必要です。開発者にとっての主な利点は、ビデオ合成のための反復的な開発サイクルを提供することです。つまり、`init` でプロジェクトを初期化し、HTML で合成を記述し、`lint`・`validate`・`inspect` で問題をチェックし、`preview` で Studio エディタで編集し、最後にユーザーの承認後に `render` で最終出力を生成します。このスキルは、ローカル実行と AWS Lambda クラウドレンダリングの両方をサポートしており、`lambda` サブコマンドは分散レンダリング用の SAM スタックをプロビジョニングします。クロスカットのエージェント規約には、`--json` フラグのサポート、非 TTY モードの自動検出、出力検証のためのレンダリング後チェックが含まれます。また、`hyperframes-core`(Tailwind/合成)、`hyperframes-registry`(ブロック/コンポーネント)、`hyperframes-media`(音声/文字起こし)などの他のスキルとの連携も定義されています。

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

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

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

ドキュメント

HyperFrames CLI

すべての操作は、プロジェクトの指示がローカルラッパーを指定している場合を除き、npx hyperframes を介して実行されます。ローカルラッパーが指定されている場合は、それに厳密に従ってください。Node.js >= 22 と FFmpeg が必要です。

ワークフロー

  1. スキャフォールド — npx hyperframes init my-video(または URL からの capture)。init はインストールされているスキルを GitHub 上の最新版と照合し、古いものがあればグローバルセットを更新します。--skip-skills フラグは現在無効化されています(一時的。skills.sh レジストリが追いつくまでの間)。そのため、すべての init がこのチェックを実行し、最新のスキルを常にプルします。
  2. 作成 — HTML コンポジションを作成します(hyperframes-core スキルを参照)
  3. Lint — npx hyperframes lint
  4. 検証 — npx hyperframes validate(ランタイムエラーとコントラスト)
  5. ビジュアルインスペクション — npx hyperframes inspect
  6. プレビュー — npx hyperframes preview で Studio(タイムラインエディター)が開きます。ユーザーはここで(視聴だけでなく)手動で何でも編集できます。そこで確認し、その後レンダリングについて尋ねてください。
  7. レンダリング — 以下のバリアントから選択します。
    • 反復: npx hyperframes render --quality draft
    • 納品: npx hyperframes render --quality high --output out.mp4
    • CI / クロスホスト再現: npx hyperframes render --docker --strict --output out.mp4
    • クラウド(長時間/大規模): npx hyperframes lambda render ./my-project --width 1920 --height 1080 --wait(以下の Lambda を参照)

プレビューの前に lint、validate、inspect を実行してください。lint は data-composition-id の欠落、重複トラック、未登録のタイムラインを検出します。validate はヘッドレス Chrome でコンポジションを読み込み、ランタイムコンソールエラーと WCAG コントラストの問題を報告します。inspect はタイムラインをシークし、バブル/コンテナまたはキャンバスの外にはみ出したテキストを報告します。また、*.motion.json サイドカーが存在する場合は、同じシークされたタイムラインに対してモーションの意図(エントランスがシーク下で発火するか、スタガー順序、フレーム内、ライブネス)を検証します。

モーションが多い作業では、スナップショット駆動の反復と *.motion.json サイドカーを推奨します。詳細な方法とモーション検証仕様については references/lint-validate-inspect.md を参照してください。

エージェント規約

すべてのコマンドに適用される横断的なルール:

  • --json は render、preview、play を除くすべてのコマンドで使用可能です。 サポートされているコマンドのエージェント / CI 呼び出しに使用してください。出力には _meta エンベロープ(CLI バージョン、利用可能な最新バージョン、更新アドバイス)が含まれます。render はステータスを stdout + 終了コードでのみ報告します。以下のレンダリング後チェックで成功を確認してください。preview / play はサーバーであり、JSON 出力はありません。
  • doctor --json は環境が壊れていても常に exit 0 で終了します。 ペイロードの ok フィールドで判定してください: npx hyperframes doctor --json | jq -e '.ok' > /dev/null。これにより、パイプラインが CLI リリースの変更から保護されます。
  • 非 TTY モードは自動検出されます。 stdout が TTY でない場合(CI、エージェント、パイプ出力)、CLI は自動的に非対話モードに切り替わります。init はその場合 --example が必須 になります。TTY 上でもこのモードを強制するには --non-interactive を渡してください。
  • CI でのレンダリングのゲーティング: --strict は lint エラーで失敗、--strict-all は警告でも失敗、--strict-variables は未宣言の --variables キーで失敗します。
  • --json 内のパスは編集されます — $HOME はリテラルの $HOME になるため、出力をバグレポートやエージェントコンテキストに安全に貼り付けることができます。
  • レンダリングはユーザーの承認が必要です。 チェックが通っても自動レンダリングは行わないでください。preview で一旦停止し、ユーザーにビデオが Studio で編集可能であることを伝え、承認を得た後にのみレンダリングしてください。
  • レンダリング後の検証。 render が exit 0 を返した後、成功を報告する前に出力ファイルが存在し、妥当なサイズであることを確認してください: [ -s "$OUTPUT" ] || echo "render produced no output"。CLI は成功時に ◇ <path> を出力します。長時間のレンダリングの場合は、ffprobe -i "$OUTPUT" -show_format -v error で長さも確認してください。

ルーティング

目的参照先
プロジェクトのスキャフォールド (init、capture、skills)references/init-and-scaffold.md
正しさの確認 (lint、validate、inspect、snapshot)references/lint-validate-inspect.md
プレビューまたはレンダリング (preview、play、render、publish)references/preview-render.md
環境の診断 (doctor、browser)references/doctor-browser.md
AWS Lambda でのクラウドレンダリング (lambda deploy / sites / render / progress / destroy / policies)references/lambda.md
その他全般 (info、upgrade、compositions、docs、benchmark、telemetry、アセット前処理)references/upgrade-info-misc.md

スキル間連携

  • Tailwind プロジェクト (init --tailwind) → クラスやテーマトークンを編集する前に hyperframes-core(Tailwind リファレンス)を使用してください。
  • レジストリブロック/コンポーネント (hyperframes add、hyperframes catalog) → インストールパス、サブコンポジションの配線、スニペットマージには hyperframes-registry を使用してください。
  • アセット前処理 (tts、transcribe、remove-background) → 音声選択、Whisper モデルルール、キャプション、TTS からキャプションへのチェーンには hyperframes-media を使用してください。
  • パラメータ化レンダリング (--variables) → <html> に data-composition-variables で宣言します。完全なスキーマについては hyperframes-core を参照してください。

Lambda(クラウドレンダリング)

hyperframes lambda は、分散レンダリングを AWS Lambda にデプロイし、ラップトップまたは CI からレンダリングを実行します。エンドツーエンドは 3 つのコマンドです:

npx hyperframes lambda deploy                                             # SAM スタック (Lambda + Step Functions + S3) をプロビジョニング
npx hyperframes lambda render ./my-project --width 1920 --height 1080 --wait
npx hyperframes lambda destroy                                            # ティアダウン (S3 バケットは保持)

Lambda は、レンダリングが 1 台のホストでは長すぎる/大きすぎる場合(数分の動画、4K、大規模な並列バッチ)に、AWS 認証情報が設定されている場合に使用します。開発ループの反復はローカルの render に留めてください。

前提条件、6 つのサブコマンドすべて(deploy、sites create、render、progress、destroy、policies)、IAM ポリシーの検証、ステートファイル、およびコスト/クリーンアップルールについては references/lambda.md を参照してください。

最小完了ゲート

静的ゲート

npx hyperframes lint
npx hyperframes validate

レイアウトが重要な作業には inspect を追加し、CI では lint エラーで失敗するように render --strict を追加してください。

ビジュアルスモークテスト — プロジェクトがサブコンポジションを使用する場合に必須

lint / validate / inspect は各コンポジションを 単独で 評価します。index.html を読み込んで data-composition-src を介してサブコンポジションをマウントすることはないため、クロスファイルのマウント障害をキャッチできません(hyperframes-core → references/sub-compositions.md、「よくある落とし穴」を参照)。それらをキャッチできる唯一のゲートは、実際に index.html を読み込み、タイムラインをシークするものです。

hyperframes snapshot を使用してください。これは render と同じ方法でプロジェクトを読み込むため(同じマウントパスを実行します)、要求したタイムスタンプのみをキャプチャするため、フルレンダリングではなく数秒で完了します:

# 各サブコンポジションの中間点で 1 フレームをキャプチャ。
# 中間点 = index.html の各ホストスロットの data-start + data-duration/2。
npx hyperframes snapshot --at <t1>,<t2>,<t3>,...

# または、シーンごとのターゲットが不要な場合は、等間隔のサンプル:
npx hyperframes snapshot --frames 9

出力は snapshots/frame-NN-at-Xs.png に保存されます。各フレームをシーンプランと照らし合わせて目視確認してください。

フレームごとのレッドフラグ(それぞれが静的ゲートが見逃す特定の障害モードに対応):

表示される内容根本原因
テキストが左上隅に小さく、スタイルが適用されずに表示される<style> ブロックが <template> の外の <head> に残っている(落とし穴 1)— CSS がライブ DOM に到達していない
SVG/アイコン要素がキャンバスサイズに拡大されている同上 — 幅/高さの制約が適用されていない
シーンのヒーロー要素が完全に欠落しており、背景とウォーターマークのみ表示されているホスト ID ≠ テンプレート ID(落とし穴 2)— タイムラインが実行されず、フレームが初期状態でキャプチャされた
スナップショットコマンドのログに Sub-composition timelines not registered after 45000ms落とし穴 2 — 直接的な確認

snapshots/ は目視確認後に削除して構いません。ユーザー向けの最終レンダリングは 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

The HyperFrames composition contract — build one renderable project. Use for composition structure, the `data-*` timing attributes, `class="clip"`, tracks, sub-compositions, variables, framework-owned media playback, deterministic-render rules, and validation. Read before writing composition HTML.

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.

関連スキル