Communitygithub.com

TurkiHassan/period-launch-video

24秒、60fps、1440²の正方形ループ動画を生成し、製品ストーリー全体をワードマークのピリオド(句点)内で展開します。Playwrightレンダリング、モーションブラー、ビート同期SFX、-14 LUFSに対応。アラビア語RTLテンプレート(Geist + Thmanyah / IBM Plex Sans Arabic)を装備。

period-launch-video とは?

このスキルは、製品ローンチ用の24秒ループ動画を生成するためのものです。動画全体が製品ロゴのピリオド(句点)の中だけで展開されるという特徴を持ち、視覚的に強いインパクトを与えます。対応プラットフォームはClaude CodeやCodexなどを想定しており、Playwrightを用いてブラウザベースでレンダリングします。指定されたワークフローに従い、新しいプロジェクトのセットアップ、入力情報(アイコン、楽曲、コピー)の収集、4枚の写真プレートの準備、ビートマップとスチル画像の承認、そして最終的なレンダリングと検証を行います。アラビア語(RTL)向けに設計されていますが、LTR製品への適応も可能です。ユーザーが「the night-shift video」や「فيديو إطلاق مربع」など特定のフレーズで依頼した場合、自動的にこのスキルが適用されます。

対応✓Claude Code✓Codex CLI~Cursor✓Gemini CLI
npx skills add TurkiHassan/period-launch-video

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

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

ドキュメント

ピリオド・ローンチビデオ

24秒のループ動画。製品の全機能が、そのワードマークのピリオド(句点)の中で展開されます。すべては template/ ディレクトリに含まれます(レンダラー index.html、すべてのコンテンツは config.js、レンダリング、スキャン、オーディオスクリプト、フォント、実際のmacOSポインター、ピーク測定済みSFX)。あなたの作業は主にコンテンツと写真の選択、そしてパイプラインの実行です。モーションを変更する前に references/craft.md を一度読んでください。そこには、方向性、ビートマップ、そして既に解決済みの注意点が書かれています。

ワークフロー

1 · セットアップ

~/.claude/skills/period-launch-video/scripts/new_project.sh <project>/brag-output/<slug>

出力先はユーザーのプロジェクト内に配置します。存在する場合は brag-output/ のようなgitignoredフォルダを使用してください。このスクリプトは、このMacから実際のmacOSポインターもコピーし(make_pointers.py、再配布不可)、Playwrightをインストールします。オリジナルの外観を再現するには、Thmanyah Sans woff2ファイル(thmanyah-sans-{400,500,700}.woff2)を assets/fonts/ に配置します。これらがない場合は、IBM Plex Sans Arabicが使用されます。

2 · プロジェクトから入力を収集(不足しているものだけを尋ねる)

  • 公開バージョンからアイデンティティを取得。 App Storeのスクリーンショット、iOSアセットカタログ(アイコン、色)、アプリ独自のサンプルデータとコピーを使用します。古いWebアセットは無視します。どのバージョンが公開中かわからない場合は、質問してください。これが最初の実行での主な修正点でした。
  • アイコン: 正方形のアプリアイコンを assets/img/icon.png にコピーします。テンプレートがiOSの角マスクを自動適用します。
  • 楽曲: プロジェクトに既存のトラックがあればそれを使用し、なければ尋ねてください。python3 find_hit.py assets/music/song.mp3 を実行し、config.song.hit(≈ 報告されたヒット − 0.04)と bpm を設定します。enterAt(デフォルト 3.10)はヒットが着地するタイミングで、最初のピルの位置です。enterAt + 20 beats が約13.5秒になるように調整し、Resultsがビート20に来るようにします。
  • コピー: config.js に記入:name(単語一つ、黒いワードマークとピリオドになる)、tagline、2行のオープンライン、askピル、job、find/write/nightラベル、3つの結果、通知、5行のライブラリ、チャートの値、CTA。すべての数字をビート間で一貫させます。半角数字。厳密なJSON形式にしてください。audio.py がこれをパースします。
  • 正直チェック: ストーリーが製品の実際の機能と矛盾する場合(例:一晩でのバッチ処理など)、レンダリング前にその旨を伝え、中立的な表現を提案します。

3 · 写真(4枚のプレート)

references/image-prompts.md に従います。利用可能なリソースに基づいてルートを選択します:

  1. クレジットのあるHiggsfield MCP。 最初に昼、次に夜と夜明けを昼のジョブの編集として、さらに外観も生成します。事前にコストを確認。
  2. ローカルCodex(which codex)。scripts/codex_image.sh はCodexの組み込みimage_gen機能をユーザーのChatGPTサブスクリプションで使用します。
  3. クレジットもCodexもない場合。 ユーザーに4つの完成したプロンプト(編集はGemini用)を渡し、ファイルを待ちます。

その後:

python3 check_align.py      # 夜/夜明けは昼とのシフトが (0,0) である必要があります
python3 grade_plates.py     # → assets/img/*.jpg + ぼかしコピー; プレビュー out/plates.jpg

4 · ビートマップ + 6枚のスチル → レンダリング前に承認を得る

node stills.mjs 1.30 7.35 10.10 14.60 17.30 23.25     # open, find, write, results, phone, out
python3 sheet.py out/review-sheet.jpg out/stills/t{1.30,7.35,10.10,14.60,17.30,23.25}.png

まず自分で全てのスチルを確認します:テキストが収まっているか、トリミングされていないか、ガラスUIがプレート上で読みやすいか。その後、ユーザーにシート(SendUserFile)と、index.html の T から生成されたビートマップテーブルを見せます。承認を得てからレンダリングします。

5 · レンダリング、検証、納品

./build.sh out/<slug>-launch.mp4     # 4レンダリングワーカー → scan.py + scan_local.py → タイムライン + オーディオ → H.264/AAC
  • scan.py はシームの差分が約0(クリーンなループ)であり、スパイクやステップがないことを報告する必要があります。
  • scan_local.py で検出されるヒットがカウンターやタイピングによるものであれば問題ありません。それ以外は実際のポップです:どのハンドオフが原因かを見つけて修正します。その後、node render.mjs a b で該当フレームのみを再レンダリングし、build.sh のffmpeg行で再エンコードします。
  • 各カウンターの最後のフレームを取得し、正確な最終数値を表示していることを確認します。
  • 仕様(1440²、60fps、1440フレーム、24.0秒、LUFS、ピーク)、未解決の正直フラグ、ファイルパスを報告します。

デフォルト以外への適応

  • リタイミング: index.html の T を編集し(0.8秒のグライドは維持)、その後 node timeline.mjs && python3 audio.py を再実行します。
  • ライブラリ行 はレイアウトにより5行固定です。チャート軸には3つのラベル(開始、中間、終了)があります。
  • LTR製品(英語ワードマーク): テンプレートはRTLでレイアウトされています。ピリオドは左端にあり、行とピルは右寄せ、スキャンとチャートは右→左に動作します。LTRの場合は、これらのアンカー(align、R/L エッジ、scanX、cpt)をミラーリングし、アイコンを左側に配置します。この作業には時間をかけ、すべてのスチルを確認してください。

関連スキル