Communitygithub.com

suntay44/motionable

社内向け motionable パイプライン(プランモード、承認、シーン、音楽、批評、レンダリング)。はじめに /motionable:scratch、:website、:project のいずれかを使用してください。

motionable とは?

このスキルは、製品の魅力を最大限に引き出す短編フィルムを制作するための社内パイプライン「motionable」の全工程を自動化します。Claude Code などのAIエージェントが、製品の事実やユーザーからの回答、画像、ブランドカラー、製品の個性などの証拠をもとに、他に類を見ないオリジナルフィルムを制作します。プランモードでは証拠に基づいた方向性(DIRECTION.md)と脚本(SCRIPT.md)を作成し、ユーザーの承認を得た後、Swiftで構築されたエンジンを用いてシーン、音楽、エフェクトをコードで生成します。自己批評機能(check)やオーディオ比較機能(compare)を備え、品質を確保した上で最終的なMP4ファイルをレンダリングし、ユーザーに提示します。主にハイプビデオなどのプロモーション映像制作を想定しており、テンポやスタイルの詳細な調整、App Storeバッジの挿入、A/Bテスト用のバリエーション作成など、高度な映像制作ワークフローをサポートします。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/suntay44/motionable/tree/HEAD/skills/make

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

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

ドキュメント

motionable: make

あなたは製品に関する事実(それぞれにソースあり)、ユーザーからの回答、画像パス、色、そしてその製品の個性に関するメモを持ってここに来ました。あなたの仕事は、この製品らしく、スタジオ内の他のどのフィルムとも異なる、完成したフィルムを作ることです。

ROOT は motionable のルートです: ${CLAUDE_PLUGIN_ROOT}。これが展開されない場合は、このファイルの実際のパス (realpath) から2階層上のフォルダを使用してください。そのフォルダには engine/ と scripts/ があります。

計画を立てる前に、ROOT/PLAN.md(プランモード)、ROOT/ENGINE.md(材料)、ROOT/rules.md(厳格なルール)、ROOT/checklist.md(批評)を読んでください。ROOT/examples/owly/ は完成品がどのようなものかを示しています。その見た目、サウンド、構成を決してコピーしないでください: それは無数の方向性のうちの一つです。

1. フィルムを作成する

  • 保存場所: フィルムは 現在のフォルダ(通常はハイプビデオ用のユーザースタジオ)内に、<slug>/ として保存します。
    • 現在のフォルダが製品自身のリポジトリである場合は、代わりに motionable/<slug>/ を使用します。
    • /motionable:project で指定された製品フォルダ内に書き込まないでください。
    • <slug>/ が既に存在する場合は、新しいバージョン(<slug>-2/)を作成するか、そのフィルムを続けるかを尋ねてください。
  • 作成方法: bash ROOT/scripts/new.sh <film> "<製品名>" を実行します。これによりエンジンがフィルム内にコピーされ、テンプレートが書き込まれます。
  • アセット: 画像を <film>/assets/ に明確な名前(logo.png、screen-home.png...)でコピーします。ユーザーが持っている場合は、ブランドフォントファイルを assets/fonts/ に配置します。

2. プランモード(内部用: コマンドなし、スタイルメニューなし)

PLAN.md を最初から最後まで実行します:

  1. 証拠ボードと個性。
  2. ストーリー: 約束、特徴的な瞬間、3つのフック → 1つに。
  3. すべてのダイヤル設定、それぞれに理由を添えて。
  4. スタジオ内での独自性: 他のフィルムの DIRECTION.md › フィンガープリント を読んでください。v0.2より前に作られたフィルムにはフィンガープリントがありません。その場合は、120 BPMのAマイナーハウスで、左揃えの見出しがカードの上に配置されているものとして扱います。
  5. 選択したテンポで DIRECTION.md と SCRIPT.md を書きます。

ユーザーにスタイルを選ばせないでください。方向性は証拠から導き出されます。

3. 一度の承認

4行のトリートメント(フィール・サウンド・ルック・特徴的な瞬間)と、コンパクトなビートグリッド(時間・映像・言葉・結合)を表示します。その後、AskUserQuestion が利用可能であればそれを使用して(そうでなければチャットで)、以下のことを尋ねます:

  1. 計画: 承認するか、何か変更するか。
  2. イラスト: 「このフィルム用にイラストを描くべきですか?」 はい、イラストを描く / 少しだけアクセント / いいえ、スクリーンショットとタイプのみ。理由を添えて一つを推奨します(PLAN.md §5)。
    • イラストを描くことは無料です: Claude がSVGを書きます。
    • セッションに画像生成ツールが接続されている場合のみ、それをオプションとして追加し、費用がかかる可能性があることを伝えてください。

承認前にはシーンコードを書かないでください。ここでの変更はコストが低いです。

4. ビルド

  1. イラスト(はいの場合): ブランドカラーと一貫した線の太さで(ENGINE.md › 描画イラスト)、SVGを assets/drawn/ に書き込みます。それぞれがシート上でどのようにレンダリングされるか確認し、ぎこちないものは描き直します。
  2. scenes/Film.swift: スケルトンを完全に置き換えます。すべての値は DIRECTION.md と SCRIPT.md から取得します:
    • 時間は enum T に格納します;
    • クリップと結合は Reel に格納します;
    • スクリーンはフレーミング呼び出しを通過させます(固定ボックスにクリップしない);
    • 特徴的な瞬間は、実際のUIと全く同じようにアニメーションするように再描画します。まずその位置を測定します: bash ROOT/scripts/inspect.sh <スクリーンショット> find <その色>(または row、column、pixel)で正確なリング、バー、テキストの端がわかります。
    • 方向性に必要なカスタム要素は、独自の scenes/*.swift ファイルに配置します。
  3. サウンド: 方向性の Recipe + Section を s.compose で、さらにすべての画像イベントに s.cue を、特徴的なサウンドを使用して追加します。
  4. ビルドを確認: bash ROOT/scripts/run.sh <film> sheet(時間指定なし:フィルム全体とすべての結合を確認)。コンパイルエラーを修正します(ENGINE.md › 注意点)。

5. ドラフト、修正、そしてユーザーに表示

ドラフト単位で作業し、無限ループしないでください:

  1. ドラフト1 は最初の完全なビルドです: シーン、音楽、すべてのキュー。フィルム自体からレビューします(以下のステップ);そのためにビデオファイルは必要ありません。(run.sh <film> draft は、ユーザーが早期に確認したい場合に、小さくて高速なMP4をレンダリングします。)
  2. 自己レビュー: 1回のパスですべてのチェックを実行。
    • run.sh <film> check: すべての ✗ は必須修正です。ラインを長く保つ、早く開始する、言葉を削る、またはラインを削除します。タイプされたラインには、タイピング時間 プラス 読み取り時間が必要です。⚠ のアドバイスにも従ってください(フレーム1、リズム)。ただし、DIRECTION.md にそうしない理由が記載されている場合は除きます。
    • run.sh <film> sheet: checklist.md のすべてのカテゴリを採点し、8未満のものを修正します。フック、特徴的な瞬間、エンドカードのフルサイズ stills を確認します: UIは判読可能か、何か衝突していないか、フレームのすべての隅が何かをしているか、意図的に空になっているか。
    • 視聴者が罰するもの(RESEARCH.md › コミュニティチェック): 読みにくいほど小さいUI、大きなもののバウンス、同じ長さのショット、ストック音楽のようなサウンド、遅いロゴの瞬間。
    • run.sh <film> audio を実行し、次に bash ROOT/scripts/compare.sh <film>: 別のフィルムと類似しすぎている場合は、理由を持ってレシピを変更します。
    • フィルム全体をステップ実行: run.sh <film> sheet $(seq 0.5 1 <長さ>)(1秒に1フレーム)。単一の静止画では隠れてしまうものを探します: 空になるシーン、動きのないビート、不快な結合、シーンが去る直前に現れるライン。
  3. ドラフト2. 見つかったすべての問題を1つのバッチで修正し、check と sheet を再度実行します。
    • それでも不合格の場合は、最大であと1回の修正パスを許可します。
    • それでも不合格の場合は、続行せずに、残っている問題とその理由をユーザーに伝えます。
    • SCRIPT.md に簡潔な批評ログを残します: 何が変更されたか、その理由。
  4. 実際のファイルをレンダリング: run.sh <film> video、30秒のフィルムで約45秒かかります。
  5. それを表示して質問する(AskUserQuestion が利用可能な場合)。MP4、4行のトリートメント、批評ログを送信し、このカットに関する3~4の的を絞った質問をします。各質問には推奨オプションが必要で、「その他」でユーザーが自由に発言できるようにします:
    • ペーシング: ちょうど良い / 遅め、少ないライン / 速め、よりパンチを。
    • サウンド: このまま / よりエネルギッシュに / より落ち着いて / 別の楽器。
    • フック: このまま、またはプランモードからの他の2つのフック候補の中で最も強いもの(名前付き)。
    • エンディング: このまま / ローンチセーフなエンディング(例:アプリ公開前にダウンロードバッジを表示しない) / 価格を追加。
  6. 回答のラウンドごとに1回改訂し、check、audio、compare を再実行してから、新しいカットを表示します。ユーザーによる2回のラウンド後、停止するか続行するかを提案します。ユーザーが決定します。

6. バッジを保存する(製品が公開されている場合のみ)

  • App Store 公開済みでユーザーがバッジを希望する場合: Apple の公式バッジ(約11 KB、黒、英語のSVG;URL は rules.md に記載)をダウンロードして assets/ に配置する許可を求めます。
    • drawAppStoreBadge で描画します。静止画でアニメーションは禁止。強調は glowRing で行います。
    • ユーザーがバッジのアニメーションを主張する場合は、Apple のルールを一度説明します。それでも希望する場合は、それを別の、明確に名前が付けられたバリアントとして作成します。
  • Google Play: アプリがそこで公開されており、ユーザーがダウンロードを承認した場合のみ、そのバッジを使用します。それ以外の場合は、最大でプレーンテキストの行のみ、そしてそれが真実である場合に限ります。

7. 納品

表示するすべてのカットに、以下を含めます:

  • 数行のトリートメント;
  • 自己レビューで修正した内容;
  • compare の結果と check の判定;
  • 投稿前に検証すべきクレーム;
  • 変更方法: SCRIPT.md または DIRECTION.md を編集するか、単に伝える。

ユーザーが満足した後、次に役立つものを提案します:

  • 15秒のカット、または別のフォーマット(1:1、16:9);
  • A/Bテスト用のフックバリアント: 同じフィルムをプランモードからの他の2つのフック候補で開始;
  • ローンチセーフなエンディング(アプリ公開前に「ダウンロード」を表示しない);
  • エフェクトのみのバージョン(run.sh <film> video effects)、プラットフォームのサウンドやライセンスされたトラックと一緒に投稿する場合。

Individual skills in this repo

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

関連スキル