Communitygithub.com

9018/mychat

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`)のエントリポイント。

mychat とは?

このスキルは、HyperFrames CLI の全機能を網羅する包括的な開発ループを提供します。Node.js >= 22 と FFmpeg を前提とし、`npx hyperframes` を起点として、プロジェクトのスキャフォールディング(`init`、`capture`)、作成、検証(`lint`、`validate`、`inspect`)、プレビュー(`preview`、`play`)、レンダリング(`render`、`lambda`)までのワークフローを統一されたコマンド体系で実行できます。特に `lint`、`validate`、`inspect` の3段階チェックにより、レンダリング前にコンポジションのエラーやアクセシビリティ問題を発見でき、`snapshot` による簡易的なビジュアルスモークテストでサブコンポジションのマウント失敗も検出します。AWS Lambda を用いたクラウドレンダリングもサポートし、ローカル環境では長時間のレンダリングや大規模な並列処理に対応できます。このスキルは Claude Code、Cursor、Codex などの AI エージェントと連携するように設計されており、`--json` フラグや非 TTY モードの自動検出により CI/CD パイプラインへの統合が容易です。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/9018/mychat/tree/HEAD/OpenMontage/.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 は環境が壊れていても常に終了コード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 が終了コード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> ブロックが <head> に残り <template> の外にある(落とし穴1)— CSSがライブDOMに到達していない
SVG/アイコン要素がキャンバスサイズに拡大表示される同上 — 幅/高さの制約が適用されていない
シーンの主要要素が完全に欠落し、背景とウォーターマークのみ表示されるHost-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.

9018/mychat

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

9018/mychat

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.

9018/mychat

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

9018/mychat

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

9018/mychat

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

9018/mychat

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.

9018/mychat

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.

9018/mychat

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

9018/mychat

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.

9018/mychat

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.

9018/mychat

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

9018/mychat

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.

9018/mychat

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

9018/mychat

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.

9018/mychat

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.

9018/mychat

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.

9018/mychat

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.

9018/mychat

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

9018/mychat

Three.js animation - keyframe animation, skeletal animation, morph targets, animation mixing. Use when animating objects, playing GLTF animations, creating procedural motion, or blending animations.

9018/mychat

Download video and audio from YouTube and 1000+ sites using yt-dlp. No API keys needed. Use when: (1) Downloading a video from YouTube or other sites, (2) Extracting audio from a video URL, (3) Downloading subtitles/captions from a video, (4) Getting video metadata without downloading.

関連スキル