Communitygithub.com

Malik-rgb43/editing-workflow

HyperFrames/GSAPを使用したモーショングラフィックス作品(プロダクト・アプリ発表、機能告知、キネティックタイポグラフィ、ロゴリビール、UI解説、アニメーションスクリーンショット)の設計、制作、レビューを行います。

editing-workflow とは?

このスキルは、HyperFrames と GSAP を使用してモーショングラフィックス作品(MP4)を制作するための包括的なワークフローを提供します。プロダクトローンチ、アプリ発表、キネティックタイポグラフィ、ロゴリビール、UI解説、アニメーションスクリーンショットなど、さまざまな用途に対応します。主な対応プラットフォームは Claude Code などの AI エージェント環境で、HyperFrames の HTML と一時停止した GSAP タイムラインを基盤とします。 このスキルの中核は「フレームレベルの PROMPT.md」です。これは、承認を得てからコーディングを開始するという厳格なルールに基づいています。人間による承認(APPROVAL 行の記録)が必須であり、コードよりも先にデザインの仕様を確定させます。また、有料生成(AI-3D、AI静止画など)は別のゲート(paid-generation-gate)を通すなど、無駄なコストを避ける仕組みが組み込まれています。 ワークフローは、レジスター(launch / kinetic / logo / explainer / calm)の選択から始まり、フレーム仕様のドラフト、ソースビートのカタログ化、コードビルド、そして厳格な品質チェック(motion_spec_check、seek_safe_scan、palette_audit など)を経て、最終的な MP4 レンダリングに至ります。レンダリングはラウンドごとに1回のみ行われ、QA レポートとともに成果物が提示されます。 このスキルは「フェイルクローズド(失敗時はブロック)」の原則に従い、ゲートの通過状態(pass / fail / blocked / n/a)を常に記録します。最終プレゼンテーションでは、ファイル、番号付き変更点、台帳のチェック、ルーブリックスコア、未検証の項目を明示します。これにより、モーショングラフィックス制作における一貫性、品質、透明性を確保します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Malik-rgb43/editing-workflow/tree/HEAD/.agents/skills/edit-motion-graphics

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

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

ドキュメント

edit-motion-graphics

完成したモーションピース(MP4)の成果責任者。HyperFrames の HTML と一時停止した GSAP タイムラインとして構築します。フレームレベルの PROMPT.md が成果物であり、コードはそれをレンダリングするだけです。

譲れないルール(最初に読むこと)

  1. 承認されたフレームレベルの PROMPT.md がない限りコードを書かない - 自律実行の場合も同様:エージェントがドラフトを作成し、人間が承認します(決定デフォルト Q6)。承認は、ファイル内の APPROVAL: <who> <date> という記録行で行います。変更順序は常に台帳 -> PROMPT.md -> コードです。
  2. ここで費用は発生させない。 AI-3D、AI静止画、または有料の生成は paid-generation-gate を通します。このスキルでは有料の呼び出しを行いません。カタログへの掲載はアカウントへのアクセス権を意味しません。
  3. レビューの順序: スタジオプレビュー -> hf_segment 範囲 -> ノートのラウンドごとに1回のフルレンダリング -> 最終レンダリングの全フレームQA。同時に処理するジョブは1つ(render_lock)。ノートはまとめて、ユーザーが書き終えるのを待たずに診断しますが、レンダリングは行いません。
  4. ハードトラップ: HyperFrames ルートに dir="rtl" を設定しない(RTLはテキスト要素のみ、<html> に lang="he");フォントはファイルから(hf/fonts/ の @font-face);hyperframes snapshot --describe false、呼び出しごとに最大5タイムスタンプ;ASCII ワークルート(new_project)。
  5. フェイルクローズド: 実行できないゲートは blocked(not_run)であり、pass にしない。タイムアウト、空のサンプル、レンダリングの欠落は決してパスしない。ツール呼び出しの成功は実行の証拠、表示されたレンダリングは出現の証拠であり、静止画は動きを証明できない。
  6. ルールと好み: ルール1〜5は絶対のルールです。以下に スタジオスタイル としてマークされた項目(デフォルトでキャプションなし、禁止リスト、「ピンク禁止」、Higgsfield 文法、21世紀ファースト)は、所有者の好みであり、その理由とともに教えられます。これと異なるブリーフがあれば、好みの部分は上書きされますが、ゲートは決して上書きされません。
  7. 数値は fps を伴う(特に指定がない限り30)、測定されたタイミングはマシン情報を伴う(所有者の Windows 11 / Ryzen 7 7435HS / RX 7600S / 32 GB)。NVIDIA/Apple のタイミングは未測定。支出、インストール、公開を制限するプロジェクトは、このスキルを上書きします。

入力 -> 出力

入力:ブリーフ/台帳(video-intake から)、ブランドキット、UIスクリーンショットまたはコンポーネント、音楽/VO。出力:hf/PROMPT.md(フレームレベル)、hf/DESIGN.md(1つの固定パレット+タイプ+モーショントークン)、hf/cues.js(映像と音声の単一タイミングソース)、hf/SOURCES.md、コンポジション、mix.wav、最終MP4、QAレポート。ハンドオフ:ノート -> revision-round;その他の比率 -> multi-video-variants(完全な再レイアウト、トリミングは不可);納品ゲート -> render-qa-deliver;参照が与えられた場合 -> reference-style-transfer を最初に(参照がない場合 -> どの時間範囲が「スタイル」か尋ねる)。

手順

  1. 登録+取り込み。 1つのレジスター(launch | kinetic | logo | explainer | calm)を選択し、長さ、アスペクト比、VO、音楽、納品物名を固定します(references/launch-register-and-pace.md)。30秒の密なローンチは x1.7 速すぎると感じられました;承認された長さは45秒でした:最初に長さを決定します。
  2. PROMPT.md + DESIGN.md のドラフト作成(6ブロック;カメラ、シーム、イベントテーブル;3D用のビートカード)。python scripts/motion_spec_check.py hf/PROMPT.md --register <r> を実行;修正;承認を求めます。
  3. ソースビート(references/ui-sources-and-port.md):カタログ化 -> hf-blocks -> shadcn レジストリ(デフォルト) -> アカウントがある場合のみ 21st.dev -> 手動構築;ビートごとに3Dを決定します(references/three-d-decision.md)。
  4. ビルド 1つの index.html + cues.js;移植されたコンポーネントはシークセーフに再作成します。その後、hf_preflight --strict、python scripts/seek_safe_scan.py hf/、python scripts/palette_audit.py hf/DESIGN.md hf/ [--png <3D renders>] を実行します。
  5. 視覚的な承認: 4枚の静止画+すべてのシームのスナップショット+sheet コンタクトシート;スタジオプレビュー;ノートをまとめます。
  6. サウンド(references/sound-and-captions.md):hf_mix --report;すべてのブランドイベントにブランドサウンド;マルチプレックスして最終ファイルを測定します。
  7. 1回のフルレンダリング ロック下で、最初にETAを提示;frame_qa、motion_qa、hf_deliver;agent-content/benchmarks/motion-graphics.rubric.md を使用して別の批評家が採点;ファイル、番号付き変更点、チェック済みの台帳、正直なギャップを提示します。

レジスター一覧(詳細:references/launch-register-and-pace.md)

レジスター新しい画面イベント頻度カメラサウンド
launch2〜6秒ごと、2以上のデプスレイヤー<= 0.5〜1秒;手動カウントで45〜110/分止まらない(ドリフト2〜4%/秒、プッシュイン8〜15%)音楽がSFX;すべてのブランドイベントにブランドサウンド;リングアウト
kinetic1〜3秒ごと最大約200/分(ワードスワップを含む)タイプがカメラキーワードが発話されてから0〜+7フレーム後に着地
logo1つのアイデア、3〜8秒0.4〜0.75秒以内に結果が見える1つの動き+静止リビール時にブランドサウンド;3ステップのエンディング
explainerアイデアごと、3〜6秒30〜110/分目的を持って、説明されているオブジェクトへVO主導;目に見える変化にのみSFX
calmホールド許容疎でも可遅いまたは固定1つの均一なベッド+微妙なフォーリー;ライザー/ドロップなし

ビートごとの3D(5行で)

ビートごとに決定し、その理由を PROMPT.md に記述します:Blender:実際のジオメトリ / ヒーローマテリアルが2秒以上画面に表示される場合(EEVEE優先;384〜640pxで1.2〜2.25秒/フレーム、ローンチあたり+1〜1.5分を測定);Three.js:データ駆動、インスタンス化、ライブテキスト付き3D-UI、ラウンドごとの編集、または正確な16進数ビートの場合、1秒の hf_segment AMD ゲート後;AI-3D:paid-generation-gate とライセンスチェックがある場合のみ;2.5D(depth_25d、Depth Anything V2 Small、2秒クリップあたり8.1〜9.9秒):小さな動きが必要な静止画用;なし:UI/メッセージビート用。3Dオブジェクトが情報を覆い隠してはならず、言葉に反応します。

「退屈 / AIっぽい / 静的」というタイムスタンプへの対処

ビートのコンセプトを置き換えます。磨き上げようとしないでください。メニューから選択:実際のVOスペクトラムで駆動されるボイスオーブ;データ駆動型ビルド(バー、カウンター、ルートグローブ);コードで再構築され、オブジェクトとして撮影されたUI(遠近感、被写界深度、150〜300%拡大);コンテンツを運ぶ共有要素モーフ;その場での数字または単語の置き換え;キーワードに着地する3Dヒーロー。小さなコーナーの「機能ピル」、小さなプッシュインのあるフラットスクリーンショット、黒背景のドットは禁止。禁止リストに行を追加し、すべての出現箇所で修正します(繰り返し発生する場合はグローバルルール)。

時間予算(所有者のマシンでモデル化または測定。学生の測定値ではありません)

目標:30〜45秒のローンチの初回提示可能なドラフトを約3〜4時間、1〜2回の修正ラウンドで作成(実際の初回ローンチは10ドラフト、7批評家ラウンド、4所有者ノートラウンドを要しました);ラウンドごとに正確に1回のフルレンダリング。レンダリングリファレンス(HyperFrames 0.8.98、E11、ヘビー40秒 / 1200フレーム):ワーカー1台 132.6秒、ワーカー4台 92.8秒、ワーカー8台 88.1秒;ブラウザGPU -12%;キャプチャがボトルネック(CPU使用率は16論理コア中2〜3のみ)。以前のプレミアムレンダリング:典型的8〜14分、観測範囲4〜21分(0.8.79〜0.8.93)。常に1ユニットをベンチマークし、3分を超えるジョブの前にETA行を投稿します。

ゲート

状態:pass | fail | blocked | n/a、常に理由を伴います。

ゲート述語証拠偽の場合所有者再チェック
G0 取り込みレジスター、長さ、アスペクト比、納品物名、VO/音楽ソース、リファレンス回答が記録されているhf/BRIEF.md質問(ラウンドあたり3〜4問);blockedvideo-intakeブリーフ変更時
G1 フレームレベル仕様6ブロック;すべてのビートにフレーム + px + イージング + サウンド + トランジションがある;禁止行;16進数パレット;APPROVAL: 行motion_spec_check.py exit 0(2 = 承認欠落 = blocked)仕様を修正;コードを書く前に停止このスキル+人間承認者再タイミングまたは新しいビート
G2 クリーン&スムーズシーンごとに1つのスプライン、各動作 >= 1.2秒、リバーサル >= 1秒かつ <= 1.3倍、すべてのキーでテキストがフレーム内に収まる;シーム出口=入口、ヒーロー永続、繰り返し技法なし、フェードなしPROMPT のテーブル+チェッカー;motion_qa レンダリングに0スタッター範囲再タイミング/再パス;磨く代わりにビートコンセプトを置き換えるこのスキルカメラまたはシームの変更時
G3 密度レジスターごと:launch = 2〜6秒ごとに新しい画面、イベント間隔 <= 0.7秒(宣言された呼吸は除く)、45〜110イベント/分(手動カウント)イベントテーブル+シーンごとに3フレームサンプルビートを追加または置換;詰め込む代わりに長い動作をx1.6倍に伸ばすこのスキル再タイミング後
G4 ビートごとの3Dすべての3Dビートにカードがある:ルート(Blender / Three.js / AI-3D / 2.5D / なし)、1文の理由、ETA、ゲート証拠、ライセンスビートカードテーブル;Three.js行:空白でない1秒の hf_segment フレーム再決定;AI-3D行は paid-generation-gate が必要このスキル新しいビートまたはアセット
G5 パレット固定1つのパレットテーブル;ソース内のすべての16進数とすべての3Dレンダリングがそれに含まれるpalette_audit.py exit 0(+ --png)色変更/再レンダリング;テーブルがない場合は blockedこのスキル新しいアセット、新しいレンダリング、色のノート
G6 UIソーシング各UI/エフェクトビートに SOURCES.md 行(原産地、ライセンス、バージョン、日付)とシークセーフな移植がある;プロジェクト内で npx shadcn add を実行しない;21stのプレビュー/メディアをコピーしないSOURCES.md+スキャンソースを交換するか、理由を添えて手動構築このスキル新しいコンポーネント
G7 シークセーフhf_preflight --strict 0エラー;seek_safe_scan.py 0エラー;非連続時刻のスナップショットが一致するレポート+スナップショットペア修正;理由なしに抑制して「修正」しないこのスキルコードパッチごと
G8 サウンドすべてのブランドイベントにブランドサウンド;VO下のSFXは -18〜-26 dB、映像より1〜3フレーム前;音楽はリングアウト;最終ファイル -14 LUFS ±0.5、TP <= -1(ハウスプリセット v1、Q5)hf_mix --report、最終ファイルで hf_deliver 検証再ミックス&リマックス(再レンダリング不要)render-qa-deliver が測定オーディオまたは映像の再タイミング時
G9 キャプションブリーフで要求されない限り、キャプション要素なしid/クラスのgrep+<direction> 行削除 / 1行で質問このスキルブリーフ変更時
G10 レンダリング+QAこのラウンドで1回のフルレンダリング;frame_qa 0フラグ;ルーブリック平均 >= 4.0、どの次元も < 3 なし、M1/M3/M7 >= 3;台帳のすべての行がチェック済みQAレポート+批評家出力失敗したゲートに戻る;エスカレーション前の最大1回の修正ラウンドrender-qa-deliver各フルレンダリング

ゲート結果の記録(hf/QA.md、ゲートごとに1行)

G1 pass   motion_spec_check exit 0, 24 beats, approval "<who> 2026-10-02"  (re-run after r2 retime: pass)
G5 blocked  3D render coin_r2.png not readable by palette_audit (not_run) - install Pillow or downscale
G7 fail   seek_safe_scan SS02 index.html:211 Math.random -> seeded hash; rescan pending

行がないゲートは not_run です。以前のラウンドの記憶から pass を書かないでください:再タイミング、新しいアセット、またはパッチはそれを無効にします(再チェック列を参照)。

ドラフトの提示(render-qa-deliver が納品ゲートを所有)

メッセージ=ファイルを一度に+番号付き変更点(ユーザー自身のノート番号による)+すべての行がチェックされた台帳+別の批評家によるルーブリックスコア+ギャップ(検証されなかったもの:ヘブライ語の校正、デバイスオーバーレイ、電話でのラウドネス)+スタジオリンク。フラグが立てられたフレーム、失敗したゲート、または未チェックの台帳行がある状態で提示しないでください。

参考文献(必要なときに読み込む)

  • references/seam-camera-event-tables.md - PROMPT.md の作成時またはレビュー時は常に;さらに agent-content/techniques/frame-spec-prompt.md と clean-smooth-motion.md。
  • references/launch-register-and-pace.md - レジスターの選択、ペースの苦情、禁止リスト、イージング数値。
  • references/three-d-decision.md - デプスまたは3Dのあるビート;2.5D については agent-content/techniques/2-5d.md。
  • references/ui-sources-and-port.md - UIカード、エフェクト、スクリーンショットアニメーション;agent-content/techniques/screenshot-rebuild.md。
  • references/seek-safe-and-render-traps.md - コードの記述、パッチ、レンダリングの違い。
  • references/palette-lock.md、references/typography-hebrew-kinetic.md、references/sound-and-captions.md - DESIGN.md、ヘブライ語タイポグラフィ、サウンドプラン。
  • references/dated-versions.md - ピンとライセンス(日付付き;期限切れ=不明)。
  • スクリプト(最初に python <script> --self-check を実行):motion_spec_check.py、palette_audit.py、seek_safe_scan.py。これらはテキストとパターンをチェックし、外観はチェックしません。

停止してエスカレーション

推測せずにブロック:承認行がない;レンダリング不可;ゲート入力欠落;価格またはライセンス不明;1秒のセグメントがAMDで空白のThree.jsビート(Blenderスプライトにフォールバック)。支出、インストール、公開、第三者へのメッセージの前に質問してください。他のエージェントセッションにメッセージを送信しないでください。タイムスタンプ付きのユーザーノート「退屈 / AIっぽい / 静的」は、レジスターのメニューからビートコンセプトを置き換えることを意味し、1行の説明で行います。

メンテナンス

変動する事実は、references/dated-versions.md とグローバルな日付付きモジュール(hyperframes-traps.md、three-d-routes.md、audio-mix.md)にのみ存在します。新しい所有者ノートはすべて、このファイルではなく禁止行に追加してください。指定された決定論的チェックのみ;モデル評価は実行しません(決定デフォルト Q4)。

Individual skills in this repo

This repo contains 5 individual skills — each has its own dedicated page.

Malik-rgb43/editing-workflow

>- Script, edit or review a paid-social ad, sponsored post or brand promo for a business, product, app or store (Meta, Instagram, TikTok, 15-60 s): exact offer and CTA, ranked hooks, hook variants, end card, blocking compliance table, licence checks. Triggers: ad, promo, sponsored, campaign; מודעה, פרסומת, קמפיין, ממומן, פרומו, מבצע, הנחה, הוק. NOT for testimonials (edit-testimonial), organic expert reels (edit-talking-head), AI-only films (edit-ai-generated), ratio exports (multi-video-variants).

Malik-rgb43/editing-workflow

>- Transcribe Hebrew speech and build burned-in Hebrew captions: ASR route per hardware, word timestamps, proofreading, RTL and mixed English/number lines, caption font, entrance and exit animation, safe zone, caption QA. Triggers: תמלול, תמלל, כתוביות, כתוביות בעברית, מילים בולטות, קריוקי, המילה יצאה לא נכון, Hebrew captions, transcribe Hebrew, word timestamps, ו/ז look-alike. NOT for translation-only, non-Hebrew ASR, analysis reports (video-analysis), or caption-free motion launches.

Malik-rgb43/editing-workflow

>- Deliver one approved video as several outputs (other aspect ratios, hook variants, platform versions, no-music/no-captions versions) or run several videos in parallel, with one shared mix, strict naming and a manifest that blocks stale derivatives. Triggers: export as 9:16 and 1:1, hook variants, variants batch; גרסאות, וריאציות הוק, כמה סרטונים יחד, 9:16 ו-16:9. NOT for a single deliverable (render-qa-deliver) or designing the master (the type skill).

Malik-rgb43/editing-workflow

>- Turn a video the user sends or links (file, or YouTube/TikTok/Instagram URL) or a folder of clips into measurements (cuts, pacing, per-frame data), keyframe sheets, a Hebrew transcript and sound analysis (SFX, BPM, key, beats, song ID). Triggers: watch, analyse, break down, transcribe this video/reel/ad; תנתח, תעבור על, תמלל, מה קורה בסרטון, קאטים, BPM. NOT for cutting or rendering (type skills), applying a style (reference-style-transfer), or captions for a final render (hebrew-captions-asr).

Malik-rgb43/editing-workflow

Turn a new video idea, brief or list of specifics into a checkable Concept Ledger and ask questions until every parameter is precise, before any concept, prompt or build. Use at the start of any new video, with or without footage, or when the user pastes a concept with specifics. Hebrew - סרטון חדש, בריף, יש לי רעיון, קונספט, תכין לי סרטון, בוא נתחיל פרויקט. NOT for notes on an existing draft (revision-round), analysing a reference (video-analysis) or paid generation (paid-generation-gate).

関連スキル