Communitygithub.com

DigitalRavagers/Experiment

カスタムHyperFrames HTMLビデオ構成オーサリングのフォールバックスキル。専門ワークフローが適合しない場合に使用し、長尺・複数シーンの作品、ブランドリール、モンタージュ、タイトルカード、モーションポスター、静的ループ、任意の長さ・形式の自由構成に対応します。

Experiment とは?

このスキルは、HyperFramesプラットフォーム上でカスタムHTMLビデオ構成を作成するための汎用的なフォールバックスキルです。特定の専門ワークフロー(製品プロモーション動画、ウェブサイト動画キャプチャ、GitHub PR動画など)が明確に適合する入力にはそちらを優先し、本スキルはそれ以外のすべてのケース(複数シーン、ブランドリール、タイトルカード、モーションポスター、データ可視化、音声リアクティブなど)をカバーします。スキルは「設計システムの確立」「プロンプト拡張」「計画」「レイアウト優先アニメーション」のステップに従い、ビジュアルアイデンティティ、コンセプトアングル、フォントペアリング、フォアグラウンド密度計画を必須とします。また、サブコンポジションやトランジションのためのモジュール化パターン、キネティックタイポグラフィ、データ可視化、3Dエフェクトなどのテクニックを提供する各ドメインスキル(hyperframes-creative, hyperframes-animation, hyperframes-core, hyperframes-media)への委譲を推奨します。出力チェックリストにはlint、validate、inspectの通過が含まれ、最終プレビューはハンドオフ時のみ表示されます。

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

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

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

ドキュメント

general-video — 汎用構成オーサリング

ルートを確認してから構築すること。 これはカスタム構成オーサリングのためのフォールバックです。入力が明らかに専門ワークフローに適合する場合は、そちらを優先してください:マーケティング製品 → /product-launch-video;一般的なサイト → /website-to-video;トピック解説 → /faceless-explainer;GitHub PR → /pr-to-video;既存フッテージ → /embedded-captions · /graphic-overlays;短いナレーションなしモーショングラフィック → /motion-graphics;Remotion移植 → /remotion-to-hyperframes。対象外: ライブ/レンダリング時データ、完成動画のNLEスタイル編集、またはHyperFramesがキャプチャできないフッテージの制作。不明な場合は、最初に /hyperframes を読んでください。

要求されたものを正確に構築すること。 タイトルカードはタイトルカードであって、タイトルカード+3つの追加シーン+アンビエント音楽+キャプションではありません。追加のシーンや要素が作品を真に向上させる場合は_提案_すること;黙って追加しないでください。小さな編集(色の修正、1つの長さの調整、1つの要素の追加)の場合は、計画ステップをスキップして直接構築に進んでください。

アプローチ

発見 — オープンエンドなリクエストのみ

漠然とした探索的なリクエスト(「ブランド用に何か作って」「かっこいいイントロ」)の場合 — 色を選ぶ前に意図を理解する:

  • オーディエンス — 誰が見るのか? 開発者 / 役員 / 一般消費者?
  • プラットフォーム — どこで再生されるのか? ソーシャル(15秒) / ウェブサイトヒーロー / 製品デモ / 社内?
  • 優先順位 — 何が最も重要か? モーション品質 / コンテンツ正確性 / ブランド忠実度 / スピード?
  • バリエーション — ベストな1案、または意味のある異なる2〜3案(異なるテンポ、エネルギー、構造 — 単なる色替えではない)?

具体的なリクエスト(「タイトルカードを追加して」「シーン3のタイミングを修正して」)の場合は、発見をスキップしてください。

ステップ 1 — デザインシステム → hyperframes-creative

まずビジュアルアイデンティティを確立します。プロジェクトにデザイン仕様がある場合はそれを読んでください(優先順位 frame.md → design.md → DESIGN.md;正確な色、フォント、制約をブランドの真実として扱います)。

仕様がない場合、色やフォントを選ぶ前に hyperframes-creative/references/house-style.md と hyperframes-creative/references/video-composition.md の両方を読まなければなりません。 house-style.md は「プロンプトを解釈し実際のコンテンツを生成する」オープナー、レイジーデフォルトリスト、レイヤーレシピを提供します; video-composition.md は「生成された」ものから「制作された」ものを区別するビデオメディアの密度/スケール/ フォアグラウンド詳細化(データバー、登録マーク、モノスペースメタデータ、「ユーザーが要求しなかった8〜10要素」)を提供します。片方だけを読むことは最も一般的なミスです — video-composition.md こそエージェントがスキップするものであり、平坦で中央揃えのウェブページ的な出力を防ぐものなのです。独自にパレットを考案してこれらをスキップしないでください; hyperframes-creative への移行はここでは必須であり、オプションの分岐ではありません。そこから、必要に応じて名前付きスタイル/ムード → references/visual-styles.md、またはインタラクティブピッカー → references/design-picker.md も取得してください。仕様/スタイルはブランドを定義するものであり、構成ルールではありません。

アングルを見つける(曖昧な概要、仕様なし): 色を選ぶ前に、一文を書いてください — この名前/言葉/トピックは何を喚起し、どのような視覚的_世界_(メタファー、設定、楽器、モチーフ)がそれを表現するのか? 例:サイバーセキュリティツール → 金庫室の扉 / 境界線スキャン線 / ロックタンブラー;瞑想アプリ → 潮汐、呼吸、ゆっくりとした光のブルーム。被写体の_意味_を読み、単なる文字だけではないように;文字通りのリスタイルよりも具体的なアングルを選んでください。これは、拡張が正しくスキップされる単一シーン作品において、プロンプト拡張(ステップ2)の安価な代替であり、「デザインされたコンセプト」と「グラデーション上の汎用ロゴ」を分けるものです。

ステップ 2 — プロンプト拡張 → hyperframes-creative

複数シーン構成のすべてで実行します(単一シーン作品と些細な編集はスキップ)。リクエストをデザイン仕様+ハウススタイルに基づいて、下流の作業が同じように読める一貫した中間表現に落とし込みます。hyperframes-creative/references/prompt-expansion.md を参照してください。

ステップ 3 — 計画

HTMLを書く前に、高レベルで考えます:

  1. 何を — 視聴者体験:物語のアーク、キーモーメント、感情のビート。
  2. 構造 — いくつのコンポジションか、サブコンプかインラインか、どのトラックがビデオ/オーディオ/オーバーレイ/キャプションを運ぶか。モノリシック単一ファイル vs モジュラーサブコンプの判断については、hyperframes-core/references/composition-patterns.md § 2つのアーキテクチャ(経験則:3回以上のハードシーンカット、または再利用されるシーンがある場合はモジュラー化;短い単一シーン作品は1ファイルのまま)を参照してください。
  3. リズム — 実装前にパターンに名前を付ける(例:fast-fast-SLOW-SHADER-hold);hyperframes-creative/references/beat-direction.md を参照。
  4. タイミング — どのクリップが長さを決め、トランジションの位置、ペーシング。
  5. レイアウト — 最初にエンド状態を構築(下記参照)。
  6. アニメーション — その後、hyperframes-animation を介してモーションを追加。

アニメーションの前にレイアウト

すべての要素を、最も可視性の高い瞬間に配置します — 完全に入場し、正しく配置され、まだ退場していない状態。最初に静的なHTML+CSSとして記述します。まだGSAPは使わないでください。

理由: 要素をアニメーション開始状態(画面外、スケール0、透明度0)に配置し、そこから着地すると_思う_場所にトゥイーンすると、実際のレイアウトを推測していることになり、重なりはレンダリングまで見えません。最初にエンド状態を構築すれば、モーションを追加する前にレイアウト問題を見つけて修正できます。

  1. 各シーンのヒーローフレームを特定 — 最も多くの要素が同時に表示される瞬間。それが構築するレイアウトです。
  2. そのフレームの静的CSSを記述。コンテンツコンテナは絶対オフセットではなくパディングでシーンを埋める必要があります:
.scene-content {
  display: flex;
  flex-direction: column;
  justify-content: center;
  width: 100%;
  height: 100%;
  padding: 120px 160px; /* パディングがコンテンツを配置;あらゆるシーンサイズに対応 */
  gap: 24px;
  box-sizing: border-box;
}

コンテンツコンテナに position: absolute; top: Npx を決して使用しないでください — コンテンツがスペースより高い場合にあふれます。絶対配置は装飾要素のために予約してください。

⚠ 上記の width/height: 100% は、すべての祖先が解決された高さを持つ場合のみ機能します。 ルートの <div data-composition-id> およびそれと .scene-content の間のラッパーはサイズ指定が必要です(ルートに position: relative; width: 1920px; height: 1080px — hyperframes-core → 「Root must be sized」を参照)。これをスキップするとflexコンテナは約0に縮み、コンテンツは左上隅に積み重なり、最初のグリフは x=0 でクリップされます — その間 lint/inspect は0問題と報告します。また、.scene-content のパディングを常に保持してください(≥80px):それはタイトルセーフマージンです。これを単なる gap に置き換えないでください。

  1. エントランスを追加 — 画面外/不可視からCSS位置へ gsap.from() でアニメーション(サブコンポジションでは gsap.fromTo() を推奨、開始状態が明示的になるため;hyperframes-core/references/sub-compositions.md を参照)。CSS位置がグラウンドトゥルースであり、トゥイーンはそこへの旅です。
  2. 退場はトランジションで処理 — hyperframes-animation/transitions/ のシーントランジションルールに従い、最終シーンのみが要素を退場アニメーションします;シーン間ではトランジション自体が退場です。

時間を超えた共有スペース: 要素Aが要素Bが同じエリアに入場する前に退場する場合、両方ともそれぞれのヒーローフレームに対して正しいCSS位置が必要です — タイムラインの順序付けにより共存を防ぎ、レイアウトステップが偶発的な重なりをキャッチします。レイヤー化されたグロー/シャドウとzスタック深度は_意図的な_重なりです;このステップは_意図しない_衝突(2つの見出しが重なる、コンテンツがフレームからはみ出す)をキャッチするためのものです。

構築 — ドメインスキルに委譲

これはスキルの全表面(description を参照)をそのリファレンスにマッピングします — 網羅的ではありません;意図がリストにない場合、hyperframes-creative(見た目/コンセプト)、hyperframes-animation(モーション)、hyperframes-core(契約)、hyperframes-media(オーディオ/キャプション)を経由してください。最初の行は追加です — それと以下の意図行の両方を読み、どちらか一方ではありません。

構築対象…最初に読むもの(順序通り)
常に — すべての非自明な作品において、以下の意図行に加えてhyperframes-creative/references/house-style.md + references/video-composition.md(ステップ1 / HARD-GATEでもゲート;「生成されたものではなく、制作された」フォアグラウンド詳細化)
キネティックタイポグラフィ / テキスト主体hyperframes-animation/techniques.md(キネティックタイプ) + adapters/gsap-easing-and-stagger.md + rules/kinetic-beat-slam.md
タイトルカード / ローワーサード / オーバーレイ / PiP / テキスト背景hyperframes-creative/references/composition-patterns.md +(中央揃え/サイズ指定フレーム用)hyperframes-core → 「Root must be sized」
ロゴ / ブランドマークリビールhyperframes-animation/rules/svg-path-draw.md(描画オン) + rules/3d-text-depth-layers.md + rules/scale-swap-transition.md
データ / 統計 / 数値hyperframes-animation/rules/counting-dynamic-scale.md + rules/stat-bars-and-fills.md + hyperframes-creative/references/data-in-motion.md
製品 / アプリ / UIデモhyperframes-animation/rules/3d-page-scroll.md + rules/cursor-click-ripple.md + rules/press-release-spring.md
オーディオリアクティブ / 音楽駆動hyperframes-creative/references/audio-reactive.md(事前バンド抽出;モーションにマッピング)
ナレーション / ボイスオーバー / キャプション / 字幕hyperframes-media(tts、transcribe、キャプションオーサリング) → hyperframes-core 経由でアセット配置
複数シーン / トランジションhyperframes-animation/transitions/overview.md 次に transitions/catalog.md(概要だけでは完了しません — GSAPレシピはカタログにあります)
モジュラー / サブコンポジションhyperframes-core/references/composition-patterns.md + references/sub-compositions.md

出力チェックリスト → hyperframes-cli

  • npx hyperframes lint と npx hyperframes validate がパスする(結果をブロック)
  • 仕様(frame.md / design.md)が存在する場合、デザイン準拠を確認 — チェックリストは hyperframes-creative/references/design-adherence.md
  • npx hyperframes inspect がパスする、またはすべてのオーバーフローが意図的にマークされている
  • コントラスト警告に対処;複数シーン作品の場合はアニメーションマップをレビュー(hyperframes-animation/scripts/animation-map.mjs)
  • プレビューを提供;MP4へのレンダリングは明示的なリクエストがあった場合のみ
  • プレビューはハンドオフ時のみ表示(安定した最終プレビューです);構築途中に表示しない — 構築フェーズのスナップショットはヘッドレス

このワークフローではないもの

  • 特定の製品 / 会社 / SaaS / ウェブサイトをマーケティング、ローンチ、プロモーションする場合 → /product-launch-video
  • コンセプト / トピック / 記事 / 仕組みの解説、製品なし → /faceless-explainer
  • GitHub PR / コード変更 → /pr-to-video
  • 既存のトーキングヘッド動画にキャプションを追加する場合 → /embedded-captions
  • 既存のRemotion構成を移植する場合 → /remotion-to-hyperframes
  • 完成動画ファイルをNLEのようにカット/編集する場合 → 対象外(HyperFramesはHTMLとメディアを決定論的タイムラインに合成します;フッテージを編集しません)

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

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

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.

関連スキル