脚本執筆スキル：映画・テレビ脚本のための24のエージェントスキル

ソフトウェアを使えば、シーンを素早く生成できます。しかし、対立を持続させ、情報をコントロールし、フォーマットを守り、改稿に耐えうる脚本を書くことは、はるかに難しい作業です。オープンソースの jtydhr88/screenwriting-skills リポジトリは、脚本執筆、テレビドラマ執筆、舞台劇、ドラマトゥルギーのための24のエージェントスキルを体系的にまとめ、その隔たりを埋めています。

このプロジェクトは、45冊の創作技法書と、23本の出版済み脚本・楽譜・戯曲から得たアイデアを、再利用可能な SKILL.md ファイルへと変換しています。これらのファイルはClaude CodeとOpenAI Codex向けに設計されていますが、エージェントに依存しない openagentskills.io 形式に従っているため、互換性のあるエージェントであれば利用できる可能性があります。

どのような問題を解決するのか？

汎用的な大規模言語モデルは、脚本に主人公、対立、シーン、セリフが必要だと理解しているかもしれません。それでも、説明過多の会話、弱いアクトアウト、一貫性のないキャラクターの動機、あるいは繰り返し機能するストーリーエンジンを持たないテレビエピソードを生み出すことがあります。

これらのスキルは、より規律ある制作プロセスを提供します。エージェントに「脚本をもっとよくして」と頼む代わりに、脚本家は次のような目的に特化した能力を呼び出せます。

支配的なアイデアを見つけ、企画の前提を検証する
長編映画やシリーズの構成を組み立てる
対立を生み出すキャラクター同士の関係網を設計する
情報伝達ではなく行動としてセリフを書き直す
エピソードをアクトとアクトアウトに分解する
シリーズバイブルや企画提案資料を作成する
小説を複数話のドラマへ翻案する
公開済み脚本や演劇の伝統を分析する
複数回の執筆セッションにわたってプロジェクトの状態を維持する

その結果は、汎用的なテキスト生成器というより、創作技法を理解した執筆アシスタントに近いものになります。

インストール

Claude Codeマーケットプレイスからのインストール

推奨されるClaude Codeのインストール方法は、プラグインマーケットプレイスを利用することです。

/plugin marketplace add jtydhr88/screenwriting-skills
/plugin install screenwriting@screenwriting-skills

スキルは /screenwriting:<skill> 名前空間から利用できます。たとえば、次のように実行します。

/screenwriting:sw-dialogue

現在の環境で読み込まれているスキルを確認するには、次を実行します。

/skills

Claude Code：すべてのプロジェクトにインストール

git clone https://github.com/jtydhr88/screenwriting-skills.git
cp -r screenwriting-skills/plugins/screenwriting/skills/* ~/.claude/skills/

Claude Code：1つのプロジェクトにインストール

mkdir -p .claude/skills
cp -r screenwriting-skills/plugins/screenwriting/skills/* .claude/skills/

Codexのインストール

Codex CLI、ChatGPTデスクトップアプリ、またはIDE拡張機能では、マーケットプレイスを追加してプラグインをインストールします。

codex plugin marketplace add jtydhr88/screenwriting-skills

続いて、Plugins → Screenwriting Skills → Install を選択します。

同じ24個の SKILL.md ファイルが、プラグインの共有 skills/ ディレクトリを通じて提供されます。Codex専用に書き直された別版はありません。

個人用のCodexインストールでは、次を実行します。

git clone https://github.com/jtydhr88/screenwriting-skills.git
cp -r screenwriting-skills/plugins/screenwriting/skills/* ~/.agents/skills/

プロジェクト専用のインストールでは、次を実行します。

mkdir -p .agents/skills
cp -r screenwriting-skills/plugins/screenwriting/skills/* .agents/skills/

$sw-story-structure のようなコマンドでスキルを明示的に呼び出すことも、エージェントに関連するコンテキストを自動検出させることもできます。

4層構造のアーキテクチャ

このリポジトリでは、スキルを4つの層に整理しています。長編映画、配信シリーズ、舞台劇、中国オペラは、いくつかのドラマの原則を共有しながらも、必要とされる構成や執筆上のルールは大きく異なるため、この点が重要になります。

1. 一般ドラマトゥルギー

媒体に依存しない層では、さまざまなプロジェクトに共通する基礎を扱います。

sw-workflow：プロジェクトの進行管理、成果物、ステージゲート、永続的な story-bible.md ファイル
sw-story-structure：プロットポイント、パラダイム、ビート、障害、危機、クライマックス、サブプロット、冒頭、結末
sw-premise-theme：前提の検証、支配的なアイデア、ログライン、テーマ上の対立、物語の核
sw-character-conflict：キャラクター心理、対立、配置、エスカレートする葛藤
sw-dialogue：行動としてのセリフ、サブテキスト、説明、キャラクターの語彙、セリフ単位の問題
sw-scene-craft：価値の転換、シーン分析、ペース、トランジション、小道具、遅く入って早く出る技法
sw-format-adaptation：脚本フォーマット、Fountain出力、中国語・日本語の脚本慣習、翻案、改稿

長編映画向けの便利なワークフローでは、前提から構成へ進み、そこからキャラクター、シーン、初稿、改稿、提出へと移行します。ワークフロースキルは各段階で関連するスキルを示し、助言的な終了チェックを定義します。

2. 媒体固有の執筆

第2層では、一般的な脚本術の本だけでは十分に教えられないルールを追加します。

sw-series-structure：ティーザー、コールドオープン、放送向けアクト構成、配信向けアクトテスト、アクトアウト、クリフハンガー、A/B/Cストーリーの織り交ぜ、パイロットのビート、シーズン全体の形
sw-series-engine-bible：反復可能なシリーズエンジン、キャラクター同士の関係網、パイロットの型、ストーリー上の地雷原、企画提案資料
sw-writers-room：ストーリーのブレイクダウン、ショーランナーの責任、スタッフの役割、文書の連鎖、ノート、スケジュール、制作上の制約
sw-sitcom-comedy：30分コメディ、ジョークの仕組み、定番ギャグ、コールドオープン、タグ、マルチカメラ、シングルカメラ、アニメーション、ドラメディ
sw-chinese-series-practice：中国のテレビフォーマット、エピソードのサスペンス、翻案ワークフロー、制作ゲート、契約、コンテンツ上の境界
sw-chinese-opera-banqiang：京劇、豫劇、越劇、秦腔、評劇、胡劇などの伝統で用いられる板腔式の歌唱体系
sw-chinese-opera-qupai：元雑劇、明清伝奇、昆曲、川劇の高腔などで用いられる曲牌体系

シリーズ層には、放送向けの17～18ページ、30ページ、45ページ、60ページ前後のページ基準や、分単位で示されたパイロットの分解など、具体的なタイミングの目安が含まれています。また、一度だけ機能する物語と、さらに多くのエピソードを生み出せるシリーズエンジンとの実務的な違いも扱います。

3. 伝統と業界

第3層では、技法を文化的・商業的な文脈に位置づけます。

アメリカの長編映画ケーススタディ
日本の脚本執筆法
韓国およびフランスの執筆アプローチ
中国のテレビ制作実務
業界、ピッチ、オプション、クレジット、エージェント、WGAの文脈、買い手向けの開発

この層は、ひとつの「普遍的な公式」を提示するのではなく、エージェントが複数の方法を比較する必要がある場合に特に役立ちます。たとえば、ダグラスの4アクト構成と、アクトブレイクは主に物語上の圧力と制作上の現実によって決まるというオーバーグの主張など、資料間の意見の違いも保持しています。

4. 完成作品コーパス

最終層では、完成作品をインスピレーションの例ではなく、実際に作業できる素材として扱います。以下が含まれます。

チェーホフの長編戯曲と一幕物の全作品
小津安二郎の脚本6本
『サクセッション』全4シーズン、撮影台本39本
『ザ・ホワイトハウス』『ザ・ソプラノズ哀愁のマフィア』『ダウントン・アビー』『Fleabag フリーバッグ』などのケーススタディ

たとえば succession-series-writing スキルでは、プレッシャー・チャンバー、儀式を軸にした容器型エピソード、屈辱への転落、サブテキストを担うト書き、一語によって引き起こされる反転、そして主要エンジンの圧力が失われた後に結末を設計する難しさを分析します。

実践的な使用例

脚本家は、自然言語によるリクエストでこのライブラリを利用できます。

12話のシリーズをアクトに分解して、アクトアウトを配置してください。

これは sw-series-structure へルーティングされるはずです。

私のセリフはすべて露骨すぎます。問題を診断して、シーンを書き直してください。

これは sw-dialogue と sw-scene-craft を組み合わせます。

40万語の小説を、40話の中国ドラマのアウトラインにしてください。

この場合は sw-chinese-series-practice と sw-series-engine-bible が必要であり、原作を黙って圧縮するのではなく、翻案上の判断を明示します。

プロジェクトを立ち上げて、現在どこまで進んでいるかを追跡してください。

これは sw-workflow の役割です。ストーリーバイブルの慣例を用いて、セッションをまたいでプロジェクトの状態を保持します。

多言語設計で単一のソースツリーを使う理由

スキル本文は中国語で書かれています。これは、参考資料の多くが中国語の原典または中国語訳で構成されているためです。ただし、エージェントの回答言語は脚本家のリクエストに従います。英語、日本語、韓国語、フランス語で尋ねれば、その言語で回答を受け取れます。

これにより、翻訳済みのスキルツリーを別々に管理する必要がなくなります。このプロジェクトには以前、英語版がありましたが、並行する複数のツリーを維持すると、長期的な同期問題が生じます。ひとつの翻訳が存在すれば、ユーザーは当然、日本語、韓国語、フランス語、ロシア語なども求めるでしょう。5言語のツリーを作れば、個別にずれていく可能性のあるファイルが何百個も発生します。

用語は sw-workflow/terms.md のマッピングで処理されます。「logline」「act out」「beat sheet」「showrunner」「staff writer」といった概念は、元の業界用語との結びつきを保ちます。きれいな同等語がない用語は、注釈を添えて原語を残すこともできます。

この設計にはトレードオフがあります。中国語を読めない読者は、基礎となる指示ファイルを直接監査できません。翻訳版READMEはインストール方法、構成、ポリシーに関する情報を提供しますが、完全なスキル表と参考文献はメイン文書および中国語文書に残されています。

スキルファイルを肥大化させずに詳細な参考資料を提供する

各スキルには、原則、ワークフロー、チェックリストを含む SKILL.md があります。ほぼすべてのスキルには、表、例、抜粋、詳細な分析を含む reference.md も用意されています。

より大きな分野の一部は、複数の参考ファイルに分割されています。たとえばシリーズのケーススタディでは、英語脚本のコレクション、パイロットの分解、アジアのテキストに分けて資料を整理しています。シリーズエンジンのスキルでは、エンジンの分解、文書フィールドの表、完成例を別々に扱います。

この分離により、運用上の指示を扱いやすく保てます。また、このリポジトリでは SKILL.md ファイルをおおむね40KB未満に抑え、プロジェクトの規約で求められるスキル説明の1,024文字制限も守ることを目指しています。

コアを弱めずに新しい媒体を追加する

このリポジトリでは、新しいジャンルに独自のスキルを与えるべきかどうかを判断するため、厳格なルールを設けています。そのジャンルが執筆の構成、フォーマット、または言語上のルールを変える必要があることが条件です。スパイスリラーや家族ドラマといった主題カテゴリーは、それだけでは対象になりません。完全で独自性のあるコーパスが専用の扱いを正当化しない限り、これらはケーススタディに含めます。

新しい媒体は、次のものを追加する必要があります。

新しいスキルを1つ
どの一般的な手法が応用できるかを説明する境界表
ワークフローのルーティング表への項目を1つ

新しい媒体を追加するたびに、一般スキルを書き直すべきではありません。このアーキテクチャにより、基本的な前提、構成、セリフ、シーンのスキルを変更することなく、シリーズ層と中国オペラ層を拡張できました。

中国オペラは、この分離が重要である理由を示しています。板腔式と曲牌は、歌唱構造、作詞方法、舞台単位が異なるため、2つの体系として扱われます。ひとつの体系内にある地域的な伝統は、参照用の付録で扱える場合が多く、地域ごとのジャンルに対して何百ものほぼ重複したスキルを作る必要がなくなります。

参考資料とライセンス

このプロジェクトは、脚本術の本17冊、テレビドラマ執筆の本15冊、出版済みの脚本と戯曲、そして中国オペラに関する広範な理論・脚本・楽譜を基盤としています。資料には、シド・フィールド、ブレイク・スナイダー、ロバート・マッキー、ラヨス・エグリ、リサ・クロン、ニール・ランドー、パメラ・ダグラス、ウィリアム・ラブキン、ジェシー・アームストロング、アーロン・ソーキン、フィービー・ウォーラー＝ブリッジ、チェーホフ、小津安二郎、そして多くの中国人作家・理論家の著作が含まれます。

このリポジトリは、個人学習用途向けにライセンスされています。引用は原著者および翻訳者の財産であり続けるため、ライセンスされた原資料の代替ではなく、学習・開発ツールとして扱うのが適切です。

誰に向いているのか？

このコレクションは、次のような人に特に適しています。

長編映画やパイロットを開発する脚本家
シリーズバイブルを構築するテレビ脚本家
ショーランナーやライターズルームの参加者
ドラマの伝統を比較する研究者
ドメイン特化型エージェントスキルを検証する開発者
小説、戯曲、既存の知的財産を翻案する脚本家
構造化された執筆演習を作る教育者

ワンクリックで「脚本を書いて」と頼めるプロンプトを探しているユーザーには、あまり向いていません。このコレクションの価値は、段階的な開発、明示的な創作上の判断、資料に裏付けられた代替案、そして繰り返しの改稿にあります。

GitHub上で1,000スター、118フォークが表示されているこのリポジトリは、専門知識をコーディングエージェント向けにパッケージ化する方法の一例として、大きな関心を集めています。最も重要なアイデアは、そのアーキテクチャです。汎用モデルに脚本術のルールをすべて一度に記憶させるのではなく、現在の執筆上の問題に応じて選択できる、小さく組み合わせ可能なスキルを与えるのです。

参考資料

jtydhr88/screenwriting-skills：脚本執筆、テレビドラマ執筆、ドラマトゥルギーのためのプロフェッショナルなエージェントスキル