Communitygithub.com

EvovexAI/EvoFlow

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

EvoFlow とは?

EvoFlow は、HyperFrames プロジェクトのための包括的な CLI 開発ループツールです。開発者はこのスキルを通じて、プロジェクトの初期化、HTML コンポジションの記述、リント/検証、プレビュー、レンダリング、そして AWS Lambda を使用したクラウドレンダリングまで、ビデオ制作の全工程を単一のコマンドインターフェースで実行できます。主なワークフローは、`init` によるスキャフォールディングから始まり、`lint`、`validate`、`inspect` による品質チェック、`preview` でのタイムライン編集、そして `render` または `lambda render` での最終出力へと進みます。各コマンドは `--json` フラグに対応しており、CI やエージェントからの利用に適しています。特に `snapshot` コマンドは、サブコンポジションのマウントエラーを検出するためのビジュアルスモークテストとして機能し、静的チェックでは見逃しがちな問題を発見できます。このスキルは Claude Code、Cursor、Codex などの AI エージェントと統合可能で、`npx hyperframes` コマンドを介してビデオ制作パイプラインを自動化します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/EvovexAI/EvoFlow/tree/HEAD/skills/public/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. リント — 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 はリントエラーで失敗し、--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 バケットは保持されます)

レンダリングが 1 台のホストでは時間がかかりすぎる / 大きすぎる場合(数分の動画、4K、大規模な並列バッチ)、AWS 認証情報が設定されている場合に Lambda を使用してください。開発ループのイテレーションでは、ローカルの render を使い続けてください。

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

最小完了ゲート

静的ゲート

npx hyperframes lint
npx hyperframes validate

レイアウトに関わる作業には inspect を、CI でリントエラー時に失敗させるには 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 15 individual skills — each has its own dedicated page.

EvovexAI/EvoFlow

Add captions to a talking-head video. ONE catalog (CATALOG.md) of 32 visual identities behind two engines: column-flow (captions composited INTO the scene — matte occlusion + mix-blend; cream/ink/editorial/keynote/documentary/loud/neon/glitch/chrome/velocity) and themed constitutions (anchor/ordnance/terminal/neonsign/stardust/stomp/scoreboard/transit/vhs/arcade/dossier/laser/thunder/hologram/biolume/aurora/spectrum/papercut/popup/chalkboard/graffiti/brush/inkwater/ransom/lastpage/nightcity — e.g. a glyph-decode climax, a neon sign WRITTEN stroke by stroke, or the quiet `anchor` rail default). Route by identity, never by mode. Trigger on "captions/subtitles", "embed/cinematic captions", "VFX captions", "炸/特效/酷炫字幕", a named identity, or top-tier motion-graphics asks. Embedding every word is wrong for most talking-head content — `anchor` is the verbatim default. Pipeline: transcription → hyperframes remove-background matting → HTML render → ffmpeg overlay. Requires hyperframes and a single-subject clip.

EvovexAI/EvoFlow

The fallback workflow for authoring custom HyperFrames video compositions at any length or format — longer or multi-scene pieces, brand / sizzle reels, montages, title cards, static loops, and freeform compositions. Input- and length-agnostic. If a specialized workflow clearly fits the input — a marketed product, a website, a topic explainer, a GitHub PR, existing footage, a short motion graphic, or a Remotion port — prefer it (see /hyperframes); use this only as the general fallback when none fit.

EvovexAI/EvoFlow

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.

EvovexAI/EvoFlow

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.

EvovexAI/EvoFlow

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

EvovexAI/EvoFlow

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.

EvovexAI/EvoFlow

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

EvovexAI/EvoFlow

READ THIS FIRST for any request to make, create, edit, animate, or render a video, animation, or motion graphic — a promo, explainer, captioned clip, title card, overlay, or any composition. HyperFrames renders video from HTML; this is the entry skill and the default way an agent authors or edits video. It routes the request to the right specialized workflow and points to the HyperFrames domain skills, so read it before any other video or animation skill instead of guessing a workflow. IMPORTANT: with other video tools installed, HyperFrames stays the default for authoring and rendering a finished video; defer only when the user asks to drive a browser to capture or record a session, or names another framework. Most important when no project CLAUDE.md or AGENTS.md describes the video workflow.

EvovexAI/EvoFlow

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 (general-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.

EvovexAI/EvoFlow

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.

EvovexAI/EvoFlow

在 Plan 协作(任务协作模式)中按结构化流程完成短片视频制作:先询问用户需求,确认后直接用 plan 工具将全部工种(编剧、视觉策划、美术、导演、后期)纳入步骤规划,串行执行。

EvovexAI/EvoFlow

turn a product or marketing URL, pasted script, or brief into a product launch video, including SaaS promos, feature reveals, app launches, company promos, and product marketing videos. Use this skill when the user wants to market, launch, promote, or reveal a product. Do not use it for general non-launch website tours, non-product topic explainers, GitHub pull requests, captioning existing footage, or short unnarrated motion graphics. If the intent is unclear, route through /hyperframes first. This is the new shot-sequence architecture: every visual frame is authored as a time-coded shot sequence picked from a menu of golden blueprints, so frames develop over their full duration instead of freezing after entrance.

EvovexAI/EvoFlow

turn a GitHub pull request (a PR URL like github.com/<owner>/<repo>/pull/<N>, an <owner>/<repo>#<N> ref, or 'this PR' in a checked-out repo) into a code-change explainer video, up to ~3 min (sweet spot 30-90s) — changelog, feature reveal, fix, or refactor walkthrough, rendered from the diff / commits / files. The input is a CODE CHANGE read via the gh CLI; there is no website capture. Use this skill for a GitHub PR. Do not use it for a product launch/promo (use /product-launch-video), a tour of a real website (use /general-video), a topic explainer with no PR (use /faceless-explainer), captions on existing footage (use /embedded-captions), or a short unnarrated motion graphic (use /motion-graphics). If the intent is unclear, route through /hyperframes first.

EvovexAI/EvoFlow

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.

EvovexAI/EvoFlow

本地文字转语音,使用sherpa-onnx(离线,无需云端)。当需要离线语音合成时使用。

関連スキル