Communitygithub.com

shot-speak

日常の言葉で表現されたショットを本物の映画言語に変換します。カメラ用語を知らない人がビデオやAIビデオプロンプトのためにショット、カメラワーク、ルックを説明する際に役立ちます。

shot-speak とは?

shot-speakは、ユーザーが日常語で表現した映像のイメージ(例:「あのふわっとした動き」、「マトリックスみたいなやつ」、「ドラマチックに見せて」、「スローモーションでズームイン」、「カメラが回り込む」、「映画っぽく」)を、正確な映画制作用語に変換するAIエージェントスキルです。このスキルは、Claude Code、Cursor、CodexなどのAIエージェントと連携し、カメラワーク、配置、レンズ、照明、カラーグレード、速度などの観点から3~4個の明確な選択肢を提示します。各選択肢にはモック静止画、平易な説明、モデルに依存しないプロンプト行、最終的なショット仕様が含まれます。また、名前付きの映画ルックを名前を使わない決定に変換したり、複数ショットのアクションシーケンスを計画したり、オプションのBlenderブロッキングプレビスを構築したり、ペーストされたビデオプロンプトをチェックしてAI特有のデフォルト設定(構図、照明、レンズ、モーション)を除去する「デスロップ」モードも提供します。このスキルは、映画制作の専門知識がなくても、ユーザーが意図する映像表現を正確に実現するための橋渡しをします。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/spivi/shot-speak/tree/HEAD

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

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

ドキュメント

shot-speak は何をしますか?

ユーザーは自分が何を感じたいかを知っています。それが何と呼ばれているのかは知りません。言葉、画像、そしてあらゆる動画生成ツールで使えるプロンプトを提供してください。

SKILL_DIRはこのファイルが置かれているフォルダです。各スクリプトはpython3(標準ライブラリのみ)で実行してください。

精神

あなたは実現を助ける存在であり、障壁ではありません。以下の手順は地図であり、チェックリストではありません。ユーザーの意図が明確な場合は、スキップ、順序変更、短縮して構いません。短い回答で十分です。

4つの厳格なゲート。これらだけがあなたを止めます:

  1. お金が発生する前に明確な同意を得ること。 1行で尋ねてください:「モック静止画4枚、約0.28 USD - 実行しますか?」
  2. ジェネレータのプロンプトに名前を使ってはならない: ブランド、映画、フランチャイズ、監督、製品、実在の人物は禁止。
  3. ユーザーの写真や個人データをプロバイダーに送ってはならない。
  4. キーを決して印刷してはならない。

クイックパス:

  • ユーザーがショットを知っている:プロンプトを提供してください。shotspeak.py prompt --phrase "..."で、選択肢のラウンドなしで1つのプロンプトが生成されます。
  • 「プロンプトだけくれ」:プロンプトを提供してください。その後、1行でモック静止画を提案します。
  • ユーザーはいつでも戻ったり、部分を混ぜたり、最初からやり直したりできます。その流れに従ってください。
  • ロック、プレビス、ラウンド、シーケンスは提案です。最終プロンプトはそれらを待つことはありません。

トーン:

  • 最初に平易な言葉、次に専門用語。各選択肢につき1つの用語を教えてください。講釈は不要です。
  • 一度に1つの質問をし、その答えが結果を変える場合のみ質問してください。
  • ユーザーのアイデアが慣例を破る場合、トレードオフを1行で伝え、ユーザーのやり方で進めてください。
  • 選択肢と画像はチャット内で表示してください。ウェブページは作成しないでください。

通常の流れ

各ステップは地図であり、チェックリストではありません。そのステップを実行するときにのみ、該当するファイルを開いてください。

  1. 聞いて解釈する。 言葉をそのまま受け取ってください。planを実行して3~4の明確な選択肢を生成します。 listen-interpret.md を開いてください。
  2. ルックが明確でない場合、見つける。 planがUNKNOWN REFERENCEまたはLOOK NOT CLEARと出力した場合。 look-references.md を開き、次に look-rounds-and-lock.md を開いてください。
  3. モック静止画。 detectを実行し、適切なルートを使用してください。mock-stills.mdを開いてください。
  4. ブロッキングプレビス(オプション、無料)。 previs/index.md を開いてください。
  5. 提示する。 各選択肢を画像とカードとともに表示してください。present.mdを開いてください。
  6. 選択、混合、変更。 chooseを実行してください。choose.mdを開いてください。
  7. 複数ショット(オプション)。 sequenceを実行してください。sequences/index.md を開いてください。
  8. デスロップモード。 ユーザーがプロンプトを貼り付けたり、テイクが偽物に見えると言った場合。deslop.mdを開いてください。

これらのファイルの読み方

以下の順序で読み、ステップに必要な情報が得られた時点で止めてください:

  1. このファイル。
  2. references/index.md:各トピックについて1行。「~が必要なときは…を開く」形式。
  3. トピックのindex.md:各子ファイルについて1行。「~のときに読む」形式。
  4. 必要な1つの子ファイル。各ファイルは100行以下です。
  5. 子ファイルの末尾にある「関連項目」リスト。さらに必要がある場合のみ参照。

フォルダ全体をロードしないでください。生成されたファイルは先頭行にその旨が記載されています:scripts/catalog.pyを変更し、その後python3 SKILL_DIR/scripts/build_references.pyを実行してください。

参照先

  • references/index.md:カメラ、照明、言葉、ルック、品質チェック、バックエンド、プレビス、シーケンスのルーター。
  • references/commands.md:すべてのshotspeak.pyコマンド、そのオプション、終了コード。

関連スキル