Communitygithub.com

jayfirke/motion-studio

新しいマシンに motion-studio ワークスペースをセットアップします。ツールの確認、不足品のインストール(承認後)、OWNER.md の作成、API キーの安全な保存、ローカルセットアップマーカーの書き込みを行います。初回実行時や「セットアップして」「環境構築して」などのリクエスト時に使用します。

motion-studio とは?

このスキルは、macOS(Apple Silicon)、Linux(Ubuntu 22.04+、Debian 12+)、WSL 2 上で motion-studio ワークスペースを完全にセットアップします。新しくクローンしたリポジトリに、個人設定(OWNER.md)、API キー(macOS のキーチェーン、または Linux/WSL 2 の secret store や private ファイル)、必要なツールや依存関係をインストールします。セットアップは段階的に行われ、各インストール前にユーザーの承認を求め、ダウンロードサイズも提示します(合計約 3 GB)。また、Fish Audio や Freesound の API キーを安全に保存し、動作確認まで行います。このスキルは Claude Code、Cursor、Codex などの AI エージェントプラットフォームで動作し、非技術的なユーザーにもわかりやすい日本語で案内します。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/jayfirke/motion-studio/tree/HEAD/.agents/skills/workspace-setup

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

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

ドキュメント

ワークスペースセットアップ

macOS(Apple Silicon)、Linux(apt を使用、Ubuntu 22.04+、Debian 12+)、Windows(WSL 2)で動作します。このリポジトリには、ルール、スキル、ツール、共有 CC0 サウンド、Previs Studio、および1つのデモフィルムが含まれていますが、機械や個人に紐づくもの(API キー、.venv、node_modules、ユーザーレベルのスキルやプラグイン、OWNER.md)は含まれていません。このスキルは、オーナーがすぐにスタジオを使えるようにします。SETUP.md は人が読むための同じ手順書です。

オーナーにはわかりやすい言葉で話しかけてください。オーナーは技術に詳しくない可能性があり、モーションデザインについて何も知らないかもしれません。一度に1ステップずつ、何をするのか、なぜ必要なのか、どのくらいの時間がかかるのかを説明してください。

厳格なルール

  • API キーをチャットで尋ねたり、入力、エコー、ログ、書き込みを絶対にしないでください。 キーは scripts/setup/keys.sh を通じて入力します。このスクリプトはオーナーが自分のターミナルで非表示入力(macOS のキーチェーン、Linux/WSL 2 では secret store または ~/.config/motion-studio/keys.env)を使用して実行します。もしオーナーが誤ってチャットにキーを貼り付けた場合:そのキーを使用したり保存したりしないでください。キーがチャット履歴に残っていることを伝え、プロバイダーのサイトでそのキーを削除して新しいキーを作成し、keys.sh で保存するように指示してください。
  • インストールはオーナーの承認が必要です(AGENTS.md の「Ask first」ルール)。install.sh の各ステップを実行する前に AskUserQuestion で承認を求め、ダウンロードサイズを明示してください。
  • 自分で sudo を実行しないでください。 macOS では Homebrew のインストーラーがパスワードを必要とします。Linux/WSL 2 では bash scripts/setup/install.sh system(apt を使用)がパスワードを必要とします。これらのコマンドはオーナーが自分のターミナルで実行します。(Claude Code のクラウドセッションでは root 権限があるため、自分で実行できます。)

手順

  1. まだリポジトリをクローンしていない場合: 現在のフォルダーが motion-studio のコピーでない(AGENTS.md に "motion-studio" が含まれておらず、scripts/setup/ ディレクトリがない)場合、まずクローンします:git clone https://github.com/jayfirke/motion-studio.git motion-studio(保存場所を尋ね、デフォルトはホームまたはカレントフォルダーの motion-studio フォルダー)。その後、そのフォルダー内で作業します。最後に、そのフォルダー内で新しいセッションを開くように伝えます。
  2. 挨拶と期待値の設定を3行で行います:セットアップの内容(ツールの確認、不足品のインストール、設定の書き込み、キーの保存)、所要時間15〜30分、ダウンロード容量約3 GB(システムパッケージ、Chromium、1.6 GB の Whisper モデル)。また、システムが検出した OS(macOS、Linux、または WSL 2)を伝えます。
  3. チェック: bash scripts/setup/doctor.sh を実行します。NEED 行(それぞれの用途)をわかりやすく説明し、OPT 行を1文でまとめます。
  4. システムツール。
  5. インストールの選択 を1つの AskUserQuestion(multiSelect)で行います。doctor が不足とマークしたものだけを提示します:
    • 「Core studio」= macOS では install.sh core(Homebrew ツール、Python venv、Claude スキル、Claude プラグイン)。Linux/WSL 2 では、system ステップの後に install.sh venv skills plugins を実行。推奨。
    • 「Whisper model, 1.6 GB」= install.sh whisper-model(キャプションと音声チェック用のワードタイミング)。推奨。
    • 「Previs Studio packages」= install.sh app(Previs Studio を再構築し、チェックを実行)。
    • 「onetake」= install.sh onetake:個人用、非商用実験のみ(PolyForm Noncommercial ライセンス)。
    • 「Motion Reel Kit」= install.sh motion-reel <kit folder>:キットをクリエイターから購入またはダウンロードした場合のみ(CREDITS.md 参照)。このリポジトリには含まれていません。 承認されたステップをワークスペースルートから実行します。時間のかかるステップ(brew、whisper-model)はバックグラウンドで実行し、何が動いているかを伝えます。ステップが FAIL … と表示した場合、修正方法を試し、一度試してもダメなら説明してから再度尋ねます。
  6. 設定の入力。 OWNER.example.md を OWNER.md にコピーし、1回または2回の AskUserQuestion で質問をします(名前、制作内容、個人/商用利用、モーションデザインの経験、デフォルトの音声、品質基準、予算と承認プロセス)。回答を OWNER.md にオーナーの言葉で書き込みます。このファイルは git 管理外で、共有されることはありません。
  7. API キー。 AskUserQuestion で今どのキーを設定したいか尋ねます:
    • Fish Audio(すべてのナレーションに必要。無料アカウントあり。無料モデル s2.1-pro-free は2026年11月30日まで無料):キーは https://fish.audio/app/api-keys/ で取得。
    • Freesound(オプション。新しい効果音を検索・ダウンロードする場合のみ。無料アカウント):https://freesound.org/apiv2/apply/ で申請し、「Client secret/Api key」と「Client id」をコピー。 その後、オーナーに自分のターミナルで bash scripts/setup/keys.sh を実行してもらいます:
    • Claude デスクトップアプリで run_in_terminal ツールが利用可能な場合、cd "<workspace>" && bash scripts/setup/keys.sh をターミナルパネルで起動し、そこで入力するように伝えます。入力中はパネルを見ないでください。
    • それ以外の場合は、ターミナル(macOS のターミナル、Linux または WSL のターミナル)を開き、cd <workspace> && bash scripts/setup/keys.sh を貼り付けるように依頼します。 完了したと言われたら、bash scripts/setup/doctor.sh --online を実行します。キーが表示されずに動作確認が行われます。
  8. オプションの追加機能(短いリストから選択):
    • Diffusion Studio(実写映像のカット、オブジェクトマスク):macOS ではアプリを https://diffusion.studio からダウンロードし、一度開いた後、install.sh diffusion-mcp を実行します。Linux では Web アプリ(https://app.diffusion.studio)として動作し、MCP は不要です。
    • claude.ai の Fish Audio コネクター(Settings → Connectors)。必須ではありません。スクリプトがキーを直接使用します。
    • Remotion は個人および3人以下の企業は無料。3人を超える企業は Remotion ライセンスが必要です。
  9. 完了。 .local/setup.json を作成します(.local/ ディレクトリを作成。git 管理外):
    {"owner": "<ファーストネーム>", "setup_at": "<UTC 時刻 (date -u +%Y-%m-%dT%H:%M:%SZ)>", "by": "workspace-setup", "doctor": "<DOCTOR 行>"}
    
    bash scripts/setup/session-check.sh を実行し(何も出力されないはず)、再度 doctor を実行します。準備ができたものとスキップされたものを報告します。
  10. 次にすべきことを伝えます:
    • このフォルダーで 新しい Claude Code セッションを開始してください。スキル、プラグイン、Diffusion MCP はセッション開始時にのみ読み込まれます。
    • デモを開く:python3 -m http.server 8790 --directory _shared/previs/studio を実行し、http://localhost:8790 にアクセス(Previs Studio と Crumb デモフィルム)。
    • 最初のプロンプト例:「<あなたの製品> の15秒ローンチリールを作成してください。まず Previs で。」

再実行

いつでも bash scripts/setup/doctor.sh を実行できます。bash scripts/setup/install.sh <step> で1つのステップを安全に再実行できます。.local/setup.json を削除すると、セットアップ全体を再度実行できます。

Individual skills in this repo

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

関連スキル