Communitygithub.com

freudianflips/breakout-launch-videos

ローンチフィルムのレビューと分析ツールマニュアル。厳しいクリエイティブディレクターのようにレンダリング済みのフィルムをレビューし、v1からv2への改善ループを促進します。

breakout-launch-videos とは?

このスキルは、AIエージェント(Claude Code、Cursor、Codexなど)向けに設計された、製品ローンチ映像の品質レビューツールです。`skills/launch-review/scripts/review.py`を実行することで、映像のリズム、カットのビートグリッドとの一致、ラウドネス、トゥルーピーク、音声テンポなどを測定し、数値レポートを生成します。また、`study_reference.sh`を使って参考映像を分析し、学習に活用できます。重要なのは、数値だけで判断せず、目視チェックリスト(継続性、ブランド適合性、視認性、リアルなUI表示など)を適用し、差別化監査を通じて競合との差別化を図ることです。すべてのレンダリングと参考映像に対して使用し、「videoをレビュー」「filmをチェック」「このカットの何が問題か」「この参考映像を研究」といったタスクに対応します。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/freudianflips/breakout-launch-videos/tree/HEAD/skills/launch-review

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

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

ドキュメント

Launch review

launch-film 配下のツールマニュアル。skills/launch-film/SKILL.md を出発点にしてください。そこに核、フックとボディのテンプレート、教訓が書かれています。このページと異なる場合は、launch-film が優先されます。

モーションの基準:呼吸のある最高のモーション、クリーンなタイポ、高速、ブランドに沿い、他社と一線を画すこと。初期のカットはすべての数値基準を満たしても、基礎的で凡庸に見える場合があります。そのため、このスキルはまず目視を重視し、数値は問題を指摘するために使用します。

1. 測定

python3 skills/launch-review/scripts/review.py film/renders/<hook>.mp4 film/review/<hook>-v1 --bpm 120 --words <words.json>

report.md(ターゲットごとに合格/警告を表示)、filmstrip.jpg(2 fps)、contact.jpg(12フレーム)を出力します。同じスクリプトで参考映像も分析可能:skills/launch-review/scripts/study_reference.sh <url> <out-dir> <bpm> は動画をダウンロードし、グリッド表示、文字起こし、レポート実行を行います。メモは保持しますが、サードパーティの動画は決してコミットしないでください。

2. 目視確認

filmstrip.jpg を上から下へ時間経過として読みます。次に、すべてのカットとトランジションの前後フレームペアを確認します(そのフックを構築後、film/ ディレクトリで npx -y [email protected] snapshot --at <cut-0.1>,<cut+0.2> --describe false を実行)。

項目合格条件
継続性シーンがカット前に静止しない;出ていく要素は動き続け、入ってくる要素は動きながら到着する
一貫性トランジションはブランドの世界(素材、モチーフ、ロゴ、製品)に由来し、標準的なクロスフェード、ブラークロスフェード、ズームスルー、プッシュスライド、フラッシュではない
スケール範囲マクロモーメント(UI要素やテキストが画面一杯になる)が少なくとも1つ、ワイドなシステムモーメントが少なくとも1つある
視認性すべての単語が電話サイズで0.6秒以上読める;1080pで28px未満のテキストは、読まれることを意図していないUI詳細以外はない
余白フレームごとに1つのアイデア;意図的に空きスペースがある;何もフレーム端に偶然触れていない
ブランドbrand/brand.json のロールのみ;ディスプレイフォント;背景や単一要素にはアクセント、長いタイプには使わない;サイトと同じロゴ
リアルな製品UIは実際のスクリーンショットや録画から取得;モックUIはサンプルと明示
主張すべての数値は真実で証明可能;所有者が公開利用を承認済み
サウンド重みのあるイベントはすべてパレットの音を使用;ロゴはほぼ無音で鳴り、スティングが入る;ナレーションはBGMの上でも明瞭

3. 差別化監査

以下の項目に文章で回答すること:

  1. ロゴの差し替え: 競合がロゴを差し替えるだけで他の何も変えずにこのフィルムを使えるか?「はい」なら不合格。
  2. ストックムーブ: HyperFramesカタログのデフォルトや参考映像に登場する動きをすべてリストアップ。それぞれをブランド独自のバージョンに変換するかカットすること。
  3. シグネチャ数: 少なくとも2つのシグネチャ(ブランドのワールドトランジション、ガラス上のモーション、ロゴのビルド、サウンドロゴ、製品固有のモーフ)が重要な瞬間を担っていること。

4. ギャップリストとv2

レポートの横に gaps.md を配置:すべての問題を「mm:ss時点で、何が悪いか、なぜ重要か、修正方法」の形式で記述。視聴者への影響度で順位付け。修正、再レンダリング、ステップ1から3を再度実行して -v2 フォルダに保存し、両方のバージョンをギャップリストと共に提供し、何が変わったかを所有者が確認できるようにします。

スコアカード

各項目を1〜5で評価:フック(最初の2秒)、継続性、リズム、タイポグラフィ、製品の明確さ、ブランド、サウンド、差別化。すべての項目で4以上で出荷可能;3以下のものはギャップリストに戻します。所有者の好みはスコアカードに優先します:何がおかしいと感じたかを推測せずに確認してください。

Individual skills in this repo

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

freudianflips/breakout-launch-videos

Build the brand kit a launch film uses from a website. Runs tools/brand-from-url.mjs on the reader's site to extract branding (colours, fonts, logo, name, tagline, copy, product images), then reviews the preview sheet with the reader and fixes any wrong role by hand. Use for "brand from website", "brand kit", "extract branding", "get our colours and fonts", "use our logo", or before the first launch film for a new brand.

freudianflips/breakout-launch-videos

Make or change a product launch film in your own brand. A film is a hook (the story before the cut) on a shared body (the name punching in, hero words cut on the voice, your product at close range, the logo lockup in near silence), built in HyperFrames from brand/brand.json and film/film.json. Holds the core, the template workflow (build, render and mix 1 hook or all of them), the generation recipes, the checks and the lessons. Use for "launch video", "launch film", "product video", "promo", "reveal", "announcement video", "new hook", "change the body", "render all launch videos".

freudianflips/breakout-launch-videos

Tool manual under launch-film (mixdown.py for buses, ducking, loudness and the brickwall). Mix and master the audio of a launch film. Music, SFX and voice-over on separate buses, the bed ducked by the voice's real envelope with a presence carve, the music dropped out for the logo, glue compression, a true-peak-safe limiter, -14 LUFS and -1 dBTP, then laid onto the rendered picture. Use after the score, the sound effects and the voice exist, for "mix", "master", "loudness", "LUFS", "ducking", "mux the audio".

freudianflips/breakout-launch-videos

Tool manual under launch-film (the motion language for launch films built in HyperFrames). Ease tokens, camera doctrine, continuity at every cut, type and cursor craft, and brand-neutral signature moves (logo build, world pass, branch and pulse, waterfall fill, identity morph, macro pull-back, rise) that replace HyperFrames' stock look. Says which HyperFrames blueprints and transitions to keep, transform or avoid. Use whenever a launch film's picture is designed or animated, for "animation", "motion design", "transitions", "camera move", "make it feel like Apple", "less template".

freudianflips/breakout-launch-videos

Tool manual under launch-film (music fitted to the edit with Higgsfield Sonilo, ACE-Step locally, or the free scratch bed). Score a launch film with music whose sections are the film's acts. Each take is measured for tempo and section energy, stretched onto the film's BPM and offset so its drop lands on the cut. Use after the storyboard's beat sheet exists, for "music", "score", "soundtrack", "background track", "the drop", "beat grid".

freudianflips/breakout-launch-videos

Tool manual under launch-film (the sound palette, the event map, the cue sheet and generated sound kits). Design the sound effects of a launch film. Builds an event map from the storyboard, the voice-over word timings and the rendered timeline, voices every event from 1 consistent palette (the free synthesised, key-locked forge, or real glass, felt, wood, marimba, clicks and air generated on Higgsfield and pitched into the film's key), and renders 1 SFX stem in a shared acoustic space. Use once picture timing and the score are fixed, for "sound effects", "SFX", "sound design", "UI sounds", "sonic logo".

freudianflips/breakout-launch-videos

Tool manual under launch-film (the brief, the story spine, the script, the beat sheet and reference studies). Turn a launch brief into a launch film's story in your own brand, with the one message, the narrative spine, the voice-over script at the right length, a beat sheet on the music's bar grid and a STORYBOARD.md where every shot names its continuity in and out, its signature move and its sound. Includes the reference study and the logo-swap differentiation test. Use first, before voice, score or motion, for "launch video script", "storyboard", "brief", "what should the launch film say", "study this reference video".

freudianflips/breakout-launch-videos

Tool manual under launch-film (voice casting, one take per line, fitting lines, stitching, forced alignment, the vintage chain, the local clone and the free scratch voice). Produce the voice-over of a launch film. Casting across every Higgsfield preset voice, one file per script line fitted into its frame, pace and length rules, word-level timestamps by forced alignment so every key word lands on its visual, and fixes for lines that run long. Use after launch-story has an approved script and before picture timing is locked, for "voice-over", "narrator", "cast a voice", "record the lines", "align the words", "scratch voice".

freudianflips/breakout-launch-videos

Tool manual under launch-film (backgrounds, plates, Blender glass and 3D shots, shader layers). Build the world a launch film lives in, in your own brand, with generated background plates (cost-gated), Blender for real 3D glass objects and camera moves rendered as alpha layers, WebGL shader layers for atmosphere, and the layer order, depth of field and grade that keep UI legible over living backgrounds. Use when a storyboard needs backgrounds, 3D or atmosphere, for "background", "plate", "3D object", "glass", "Blender", "shader", "atmosphere"; motion of the UI itself is launch-motion.

関連スキル