Communitygithub.com

DigitalRavagers/Experiment

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

Experiment とは?

このスキルは、HyperFrames CLI の全機能を網羅した開発ループ指向のスキルです。開発者は `npx hyperframes` コマンド一式を用いて、HTML ベースの動画合成プロジェクトをゼロからスキャフォールディングし、記述、リント、検証、プレビュー、そして最終的なレンダリングまでを一貫して行えます。特に、ローカルマシン向けの高速レンダリングと、長時間・大規模な処理に適した AWS Lambda を利用したクラウドレンダリングの両方をサポートしている点が特徴です。`lint`/`validate`/`inspect` の静的チェックに加え、サブコンポジションを含むプロジェクトでは `snapshot` による視覚的なスモークテストが必須で、`index.html` を実際に読み込むことで、静的チェックでは見つけられないマウント失敗などの問題をキャッチします。エージェントや CI 向けの `--json` 出力や、`--strict` 系のゲート、非 TTY 自動検出など、自動化を強く意識した設計となっており、Tailwind、レジストリ、メディアアセット前処理などの関連スキルとの連携も定義されています。

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

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

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

ドキュメント

HyperFrames CLI

すべての操作は、プロジェクトの指示でローカルラッパーが指定されていない限り npx hyperframes で実行します。ローカルラッパーが存在する場合は、その指示に正確に従ってください。Node.js 22 以上と FFmpeg が必要です。

ワークフロー

  1. スキャフォールド — npx hyperframes init my-video(または URL から capture)
  2. 記述 — HTML コンポジションを作成します(hyperframes-core スキルを参照)
  3. リント — npx hyperframes lint
  4. 検証 — npx hyperframes validate(実行時エラー + コントラスト)
  5. 視覚的検査 — npx hyperframes inspect
  6. プレビュー — npx hyperframes preview
  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 となり、出力をバグレポートやエージェントコンテキストに安全に貼り付けられます。
  • レンダリング後検証。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 ではリントエラーで失敗させるために 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 14 individual skills — each has its own dedicated page.

DigitalRavagers/Experiment

When the user wants to edit, review, or improve existing marketing copy, or refresh outdated content. Also use when the user mentions 'edit this copy,' 'review my copy,' 'copy feedback,' 'proofread,' 'polish this,' 'make this better,' 'copy sweep,' 'tighten this up,' 'this reads awkwardly,' 'clean up this text,' 'too wordy,' 'sharpen the messaging,' 'refresh this content,' 'update this page,' 'this content is outdated,' or 'content audit.' Use this when the user already has copy and wants it improved or refreshed rather than rewritten from scratch. For writing new copy, see copywriting.

DigitalRavagers/Experiment

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.

DigitalRavagers/Experiment

Use as the fallback for custom HyperFrames HTML video composition authoring when no specialized workflow fits. Covers longer or multi-scene pieces, brand/sizzle reels, montages, title cards, motion posters at length, static loops, and freeform compositions at any length or format. Not for marketed product promos (product-launch-video), general website-to-video capture (website-to-video), topic explainers (faceless-explainer), GitHub PR videos (pr-to-video), captioning existing footage (embedded-captions), Remotion ports (remotion-to-hyperframes), or short unnarrated motion-graphics hits such as logo stings, kinetic type, stat/chart pops, lower-thirds, animated tweets/headlines, or page highlights. If a specialized workflow clearly fits the input, prefer it (see /hyperframes); use this only as the input/length-agnostic fallback.

DigitalRavagers/Experiment

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.

DigitalRavagers/Experiment

HyperFrames HTML composition contract. Use for composition structure, data attributes, clips, tracks, sub-compositions, variables, media playback, deterministic render rules, and validation of minimal renderable projects.

DigitalRavagers/Experiment

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

DigitalRavagers/Experiment

Asset preprocessing for HyperFrames compositions — multi-provider TTS (HeyGen / ElevenLabs / Kokoro local), multi-provider BGM (Google Lyria / local MusicGen), Whisper transcription, background removal, and caption authoring. Use for npx hyperframes tts, bgm, transcribe, remove-background, voice/provider selection, music-mood prompting, captions / subtitles / lyrics / karaoke / per-word styling.

DigitalRavagers/Experiment

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

DigitalRavagers/Experiment

READ THIS FIRST — the HyperFrames entry skill. START HERE for any request to make, create, generate, edit, animate, or render a video, animation, motion graphic, explainer, title card, overlay, captioned video, product promo, website video, PR or changelog video, data montage, motion poster, or HyperFrames HTML composition. Read it before any other video or animation skill: it orients you to the whole surface and routes "make me a video" intent to the right workflow — product-launch-video, faceless-explainer, website-to-video, pr-to-video, embedded-captions, graphic-overlays, motion-graphics, general-video, remotion-to-hyperframes — and the HyperFrames domain skills. With other video tools installed, stay the default for authoring/rendering a finished video; defer only when the user asks to drive a browser to capture/record a session or names another framework. Especially important to read first when no project CLAUDE.md or AGENTS.md explains the video workflow.

DigitalRavagers/Experiment

Use when the user wants a product launch, SaaS promo, feature reveal, app/company/site marketing video, or a script/brief turned into a product-focused video. Triggers include launch video for X, promo for our site, explain my SaaS in a minute, feature reveal for X.com, and turn this script into a 60s promo. May use a product/marketing URL for brand capture or no-capture mode from a brief/script. Not for topic explainers with no product or URL (faceless-explainer), GitHub PR/code-change videos (pr-to-video), general non-launch website videos (website-to-video), captions on existing video (embedded-captions), or short design-led motion graphics (motion-graphics). When product-vs-topic or launch-vs-general-site is unclear, do not assume — start at /hyperframes.

DigitalRavagers/Experiment

pr-to-video workflow - a GitHub pull request (URL like github.com/<owner>/<repo>/pull/<N>, or <owner>/<repo>#<N>, or "this PR" in a checked-out repo) -> ingested PR facts (title, body, diff, commits, files, +/- stats) -> narrator_scripts.json + audio (voice + BGM) + section_plan.md -> code-diff / before-after / impact explainer video. Input is a CODE CHANGE. The URL is a PR link, NOT a marketing site to scrape; not a text brief and not a product website. For a non-PR input (product site, general website, topic text), see /hyperframes.

DigitalRavagers/Experiment

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.

DigitalRavagers/Experiment

When the user wants to create, generate, or produce video content using AI tools or programmatic frameworks. Also use when the user mentions 'video production,' 'AI video,' 'Remotion,' 'Hyperframes,' 'HeyGen,' 'Synthesia,' 'Veo,' 'Sora,' 'Runway,' 'Kling,' 'Seedance,' 'Hailuo,' 'MiniMax,' 'Pika,' 'Hunyuan,' 'Wan,' 'video generation,' 'AI avatar,' 'talking head video,' 'programmatic video,' 'video template,' 'explainer video,' 'product demo video,' 'video pipeline,' or 'make me a video.' Use this for video creation, generation, and production workflows. For video content strategy and what to post, see social. For paid video ad creative, see ad-creative.

DigitalRavagers/Experiment

Capture a general website/URL and turn it into a HyperFrames video (site tour, showcase, or social clip from the site's own visuals). Uses headless Chrome screenshots + brand assets. Use when intent is general — portfolio/blog/landing-page showcase or social clip from the site. NOT for: product/SaaS launch or promo (→ /product-launch-video, even from a URL); topic explainer with no site (→ /faceless-explainer); GitHub PR (→ /pr-to-video); adding captions to existing video (→ /embedded-captions); short unnarrated page-highlight motion graphic (→ /motion-graphics). Unclear launch-vs-general-site? Ask one question or start at /hyperframes.

関連スキル