mcpField
S
storyboard-manager

storyboard-manager

github.com/ailabs-393クリエイティブ・メディア4601.4k 回インストール50 週間前に更新
リポジトリ

storyboard-manager について

Claude向けの創作支援スキルで、キャラクター開発、ストーリー設計、章やシーンの執筆を支援します。既存のプロジェクトフォルダーに対応し、タイムライン追跡と整合性確認のスクリプトも備えています。

主な機能

  1. 01キャラクター設定と人物の成長
  2. 02物語構成に基づくプロット設計
  3. 03章・シーン・会話の執筆
  4. 04タイムライン追跡スクリプト
  5. 05連続性と整合性の確認
  6. 06プロジェクトフォルダー構成への適応

活用シーン

  1. 01キャラクターの背景や関係性の設計
  2. 02小説や脚本の構成計画
  3. 03前章との整合性を保つシーン執筆
  4. 04物語の時系列や矛盾の確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/ailabs-393/ai-labs-claude-skills --skill storyboard-manager

インストール後、Claude Code で/storyboard-managerを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

index.js
package.json
references/
character_development.md
story_structures.md
scripts/
consistency_checker.py
timeline_tracker.py

詳細

ストーリーボードマネージャー

概要

ストーリーボードマネージャーのスキルは、創作ワークフローに役立つ専門知識とツールをClaudeに提供します。キャラクター開発、ストーリー構成のパターン、自動タイムライン追跡、物語プロジェクト全体の整合性チェックのためのフレームワークを提供します。このスキルは、さまざまなストーリーボードのフォルダー構成に自動的に適応しながら、小説、脚本、連載形式のフィクション制作におけるベストプラクティスを維持します。

主な機能

このスキルは、次の4つの主な機能を提供します。

1. キャラクター開発と管理

バックストーリー、変化の軌跡、人間関係を備えた、深みと一貫性のあるキャラクタープロフィールの作成を支援します。

2. ストーリーの企画と構成

確立されたフレームワーク(三幕構成、ヒーローズ・ジャーニー、セーブ・ザ・キャットなど)を使ったプロットの展開をガイドし、物語の要素の整理を支援します。

3. 章とシーンの執筆

確立されたキャラクターやプロットとの一貫性を保ちながら、章の内容、シーンの構成、台詞を生成します。

4. タイムラインの追跡と整合性チェック

自動化ツールを使って、時系列の整合性、キャラクターの一貫性、世界設定の整合性を確認します。

プロジェクト構成の検出

ストーリーボードマネージャーは、さまざまなフォルダー構成を自動的に検出し、適応します。次のような一般的なディレクトリパターンを確認してください。

キャラクターフォルダー: characters/、Characters/、cast/、Cast/ 章フォルダー: chapters/、Chapters/、scenes/、Scenes/、story/ 企画フォルダー: story-planning/、planning/、outline/、notes/ 概要ファイル: summary.md、README.md、overview.md

起動したら、プロジェクトのルートをスキャンして構成を特定し、それに応じてワークフローを調整します。標準的な構成がない場合は、characters/、chapters/、story-planning/、summary.md のパターンでファイルを整理することを推奨します。

ワークフローの判断ツリー

この判断ツリーを使って、適切なワークフローを判断してください。

User Request
├─ Character-related? ("develop character," "create backstory," "character arc")
│  └─ → Character Development Workflow
│
├─ Planning/Plot? ("outline story," "plan act 2," "plot structure")
│  └─ → Story Planning Workflow
│
├─ Writing content? ("write chapter," "generate scene," "continue story")
│  └─ → Chapter/Scene Writing Workflow
│
└─ Checking/Analysis? ("check consistency," "track timeline," "find contradictions")
   ├─ Timeline? → Use timeline_tracker.py script
   └─ Consistency? → Use consistency_checker.py script

キャラクター開発ワークフロー

ステップ 1:コンテキストの収集

キャラクターを開発する前に、既存のキャラクターファイルを読み、次の内容を把握してください。

  • 確立された命名規則とプロフィールの形式
  • 既存のキャラクターと人間関係
  • ストーリーのジャンルとトーン
  • すでに使用されているキャラクターのアーキタイプ

Read ツールを使って、characters ディレクトリ内の既存のキャラクターファイルを確認します。

ステップ 2:キャラクター開発フレームワークの参照

詳細なキャラクター設定のガイダンスが必要な場合は、次の内容を含む references/character_development.md を読みます。

  • キャラクターの基本要素(性格、動機、目標)
  • バックストーリーのフレームワーク(幽霊/傷、形成的な人間関係)
  • キャラクターアークの種類(前向きな変化、フラット、後ろ向きな変化)
  • 人間関係の力学
  • 話し方を作り込むテクニック
  • 一貫性のガイドライン

特定のガイダンスを効率よく見つけるには、Grep を使って関連するセクションを検索します。

# Example: Find guidance on character arcs
grep -i "character arc" references/character_development.md
ステップ 3:キャラクタープロフィールの作成

次の重要な要素を使って、キャラクタープロフィールを作成または充実させます。

基本情報

  • 名前、年齢、役割、外見
  • 主な性格特性(長所と短所の両方)

背景

  • 出身と形成的な経験
  • 行動に影響を与える幽霊/傷
  • 主な人間関係と家族の力学

キャラクターアーク

  • 物語の開始時点での信念または欠点
  • 欲求と必要性(外的な目標と内面的な成長)
  • 変化の過程
  • 最終的な状態

人間関係

  • 他のキャラクターとのつながり
  • 関係の種類(味方、ライバル、メンターなど)
  • 人間関係の変化

独自の要素

  • 能力、スキル、特別な知識
  • 秘密や隠された側面
  • 話し方や会話のパターン
  • キャラクター固有の癖
ステップ 4:一貫性の確認

次の資料と照合してください。

  • 既存のキャラクタープロフィール(役割や特性の重複を避けます)
  • ストーリーの企画文書(プロットの要件との整合性を確認します)
  • 概要/全体像(ジャンルとトーンを合わせます)
ステップ 5:作成または更新するファイル

キャラクタープロフィールを characters/[character-name].md にマークダウン形式で記述します。他のキャラクターファイルにある既存のスタイルと構成に合わせてください。

ストーリー企画ワークフロー

ステップ 1:現在の企画状況を確認する

既存の企画ドキュメントを読み、以下を把握します。

  • ストーリーのコンセプトと前提
  • すでに決まっているプロットの要点やアウトライン
  • 対象読者とジャンル
  • テーマと中心となる問い
  • 企画されている構成(あれば)

story-planning/ や outline/ のようなフォルダー、または summary.md のようなファイルを確認してください。

ステップ 2:ストーリー構成の参考資料にアクセスする

構成に関する詳しいガイダンスを得るには、以下を含む references/story_structures.md を読んでください。

  • 三幕構成
  • 英雄の旅(キャンベルのモノミス)
  • Save the Cat ビートシート
  • キャラクターアークのテンプレート
  • シーン構成の要素
  • ジャンルごとのペース配分のガイドライン
  • サブプロットの統合手法
  • ジャンル特有の構成

Grep を使って、特定のフレームワークを検索します。

# Example: Find Three-Act Structure details
grep -A 20 "Three-Act Structure" references/story_structures.md
ステップ 3:必要な構成を判断する

ユーザーのリクエストとストーリーのジャンルに基づいて、適切なフレームワークを提案します。

  • スリラー/ミステリー:ミッドポイントで強い反転を入れた三幕構成
  • ファンタジー/アドベンチャー:冒険を描く物語には英雄の旅
  • YA/現代もの:感情のビートを効果的に配置できる Save the Cat
  • 文学小説:キャラクターアークの構成に重点を置く
  • ロマンス:関係性のビートを含むジャンル特有の構成
ステップ 4:企画ドキュメントを作成する

以下の内容で企画ドキュメントを作成または充実させます。

ストーリー概要

  • 2~3文でまとめた前提
  • ジャンル、対象読者、トーン
  • 中心となるテーマと問い

プロット構成

  • 重要な出来事を含む幕/章ごとの構成
  • きっかけとなる出来事とプロットポイント
  • ミッドポイントでのどんでん返し、または真相の判明
  • クライマックスと結末

キャラクターアーク

  • 各主要キャラクターがどのように変化するか
  • プロットのビートとのアークの統合

世界構築の要素(該当する場合)

  • 舞台と場所
  • 魔法体系またはテクノロジー
  • 社会構造や規則
  • 歴史的背景

タイムライン

  • ストーリーの期間
  • 重要な出来事の順序
  • ペース配分に関する考慮事項
ステップ 5:企画ファイルを作成する

企画ドキュメントを story-planning/[document-name].md に記述します。移動しやすいよう、マークダウンの見出しを使って明確な階層構造にしてください。

章とシーンの執筆ワークフロー

ステップ 1:ストーリーの文脈を把握する

コンテンツを書く前に、以下を漏れなく読んでください。

キャラクターファイル:キャラクターの声、動機、アークを理解するため、関連するキャラクタープロフィールをすべて確認します。
企画ドキュメント:ストーリー構成、プロットポイント、現在のストーリーの進行位置を確認します。
前の章:一貫性を保つため、直近の章を読みます(少なくとも前の 1~2 章を読んでください)。
概要:ストーリー全体の前提とテーマを確認します。

これにより、新しいコンテンツが確立済みの要素に沿うようにできます。

ステップ 2:章に必要な要素を特定する

以下を判断します。

  • ストーリー上の位置:全体構成のどこに当たりますか?
  • 視点人物:誰の視点ですか?
  • シーンの目標:このシーンで視点人物が望んでいることは何ですか?
  • 対立:その目標を阻むものは何ですか?
  • 結末:シーンはどのように終わりますか?(通常は困難が生じます)
  • キャラクターの成長:ここではどのようなアークのビートが生じますか?
  • プロットの進展:どのようなストーリー上の問いが提示または解決されますか?
ステップ 3:章を構成する

シーン構成の要素を適用します。

シーン(行動)

  1. 目標 — 視点人物が追い求めるもの
  2. 対立 — 直面する障害
  3. 災難 — 物語を先へ進める否定的な結果

続編(反応)

  1. 反応 — 災難に対する感情的な反応
  2. ジレンマ — 選択肢を検討すること
  3. 決断 — 次の目標につながる選択

緊張感の高いビート(行動、対立)と低いビート(内省、世界構築)を交互に配置し、ペースを調整します。

ステップ 4:キャラクターの一貫性を保って書く

以下を参考に、キャラクターの声を保ちます。

  • すでに確立されている性格特性
  • 話し方のパターンや語彙
  • 行動のパターン(ストレス下、嬉しいとき、意思決定の仕方)
  • キャラクターアークにおける現在の位置
  • その場にいる他のキャラクターとの関係
ステップ 5:タイムラインマーカーを統合する

時系列を明確に保つため、タイムラインの参照を含めます。

  • 明示的なマーカー:「3日目」「2週間後」
  • 暗黙的なマーカー:時刻、季節を示す描写、出来事への言及
  • 形式:章のヘッダーまたは区切りに **Timeline:** Day 5, Evening
ステップ 6:章ファイルを作成する

章の内容を chapters/chapter-[number].md または chapters/[chapter-name].md に書き込みます。以下を含めます。

章のヘッダー

# Chapter [Number]: [Optional Title]

**Timeline:** [When this occurs]
**POV:** [Character name]
**Location:** [Where this takes place]

章の内容

  • シーンごとの展開
  • 会話とアクション
  • 登場人物の思考(視点人物)
  • 描写要素
ステップ 7:連続性に関する要素を記録する

執筆後、新たに導入した情報を記録します。

  • 登場人物の新たな一面や成長
  • プロット上のポイントや手がかり
  • 世界設定の詳細
  • タイムライン上の出来事

これは、以降の章で一貫性を保つのに役立ちます。

タイムラインの追跡

タイムライン追跡を使用するタイミング

次の場合は、タイムライン追跡ツールを実行します。

  • ユーザーがタイムラインの分析や出来事の順序付けを求めている
  • 時系列の一貫性を確認する
  • 章をまたいだ出来事の順序を計画する
  • 明示されていない期間を特定する
タイムライン追跡ツールの実行

プロジェクトのルートからスクリプトを実行します。

python3 .claude/skills/storyboard-manager/scripts/timeline_tracker.py . --output markdown

出力形式のオプション:

  • markdown - 人間が読みやすいレポート(デフォルト)
  • json - さらなる処理に使える構造化データ
タイムライン出力を理解する

スクリプトは次の情報を提供します。

統計

  • 追跡されたイベントの合計数
  • 登場するキャラクターの合計数
  • キャラクターごとのイベント数

タイムライン表示

  • イベントの時系列順
  • 章/シーンの位置
  • 各イベントに登場するキャラクター
  • イベント内容のプレビュー

警告

  • タイムラインマーカーのないイベント
  • キャラクターファイルで定義されていないのに言及されているキャラクター
タイムライン結果への対応

追跡ツールを実行した後:

  1. 警告を確認する - 章にマーカーを追加し、タイムラインマーカーの不足に対処します
  2. 順序を確認する - イベントが論理的な順序で発生していることを確かめます
  3. 空白を特定する - イベントのない期間がないか確認します
  4. キャラクターを追跡する - キャラクターの登場がその人物の展開と一貫していることを確認します

不足している箇所では、章にタイムラインマーカーを追加します。

**Timeline:** Day 7, Morning

または、インラインマーカーを使用します。

Three days had passed since the incident...

一貫性の確認

一貫性確認を使用するタイミング

次の場合は、一貫性チェッカーを実行します。

  • ユーザーが一貫性の分析を求めている
  • 章や幕を最終確定する前
  • キャラクターやプロットに大幅な変更を加えた後
  • 矛盾や誤りを追跡するとき
一貫性チェッカーの実行

プロジェクトのルートからスクリプトを実行します。

python3 .claude/skills/storyboard-manager/scripts/consistency_checker.py . --output markdown

出力形式のオプション:

  • markdown - 問題の詳細を含む、人間が読みやすいレポート(デフォルト)
  • json - プログラムによる分析に使える構造化データ
一貫性チェックの出力を理解する

スクリプトは、次の3つの重大度レベルで問題を特定します。

重大(🔴)

  • 直ちに対処が必要な重大な矛盾
  • 死亡後に登場するキャラクター
  • 根本的なプロットの矛盾

警告(⚠️)

  • 確認が必要な潜在的な不整合
  • 年齢の相違
  • 外見描写の矛盾
  • 人間関係の食い違い

情報(ℹ️)

  • 軽微な問題や相違
  • 名前の大文字・小文字の表記の不一致
  • 文体上の違い
一貫性チェックの結果への対応

報告された問題ごとに、次の手順を実行します。

  1. フラグが付いた箇所を読む - 言及されているファイルを確認します
  2. 正しい情報を決める - どちらの内容が正しいか判断します(通常はキャラクタープロフィールを正とします)
  3. ファイルを更新する - Edit ツールを使って矛盾を修正します
  4. チェッカーを再実行する - 修正によって問題が解決したことを確認します

キャラクターの年齢に不整合がある場合のワークフロー例:

Issue: Age inconsistency for Maya
- Profile: 18 years old
- Chapter 3: mentions "21-year-old Maya"

Fix: Edit chapter-3.md to change "21-year-old" to "18-year-old"
一貫性チェックの限界

自動チェッカーで検出できる内容:

  • 外見や身体的特徴の矛盾
  • 年齢の相違
  • 名前の表記の揺れ
  • 基本的な世界設定の事実

チェッカーで検出できない内容:

  • 微妙な性格の不一致
  • 複雑なプロットの論理的な誤り
  • テーマ上の矛盾
  • ニュアンスを伴う人間関係の変化

一貫性を深く確認するには、手動でのレビューも欠かせません。

ベストプラクティス

コンテキストの段階的な読み込み

すべての参照ファイルを一度に読み込まないでください。代わりに、次の手順で進めます。

  1. まずプロジェクトの構成を確認します
  2. 現在のタスクに関連するキャラクターファイルだけを読み込みます
  3. 具体的な指針が必要な場合にのみ、参考ドキュメントを参照します
  4. 大きな参考ファイルから該当するセクションを見つけるには、Grep を使用します
ジャンルに合わせた語り口

物語で確立されているトーンに合わせます。

  • YA:現在形、感情にすぐ訴えかける表現、現代的な言葉遣い
  • ファンタジー:豊かな描写、世界設定との統合
  • スリラー:短い文、高まる緊張感、五感に訴える描写
  • 文芸小説:複雑な文章、内省、象徴的な要素

summary.md を参照して対象読者を確認し、適宜調整します。

キャラクターアークの統合

各章でキャラクターアークを展開させます。

  • 各キャラクターがアークのどの段階にいるかを把握します
  • 突然の変化ではなく、少しずつ変化していく様子を描きます
  • プロット上の出来事を通して、キャラクターの信念を試します
  • 選択や行動を通して成長を示します
描写と説明のバランス

物語を書く際は、次のように使い分けます。

  • 感情は行動、会話、身体的な反応を通して描写します
  • 時間の経過を圧縮したり、必要な情報を効率よく伝えたりする場合は説明します
  • キャラクターの視点に沿った描写を使います(この視点人物は何に気づくでしょうか?)
複数の視点人物への対応

複数の視点を使う物語では、次の点に注意します。

  • 視点人物ごとに異なる語り口を作ります
  • 各視点のセクションで、その人物のアークとプロットの両方を進展させます
  • キャラクターごとに文の構造や語彙を変えます
  • 各キャラクターが知っていることと知らないことを把握します

よくあるユーザーの依頼と対応

「キャラクターの過去を考えるのを手伝って」
  1. 文脈を把握するため、既存のキャラクターファイルを読みます
  2. キャラクタープロフィールがあれば、内容を充実させるために読みます
  3. 過去を構成する枠組みについて、character_development.md の参考資料を参照します
  4. 傷や心のわだかまり、形成期の人間関係、重要な過去の出来事を含む、詳細な過去を作成します
  5. キャラクターアークと物語上の役割に反映します
「次の章を書いて」
  1. summary.md と物語のプロット計画書を読みます
  2. その章に登場するキャラクター全員のプロフィールを読みます
  3. 話のつながりを保つため、直前の2章を読みます
  4. 物語構成における章の位置を確認します
  5. シーン/シークエルの構成で章を書きます
  6. 時系列を示すマーカーと、視点/場所の見出しを含めます
「第2幕のアウトラインを作って」
  1. あらすじと既存のプロット計画書があれば、それらを読みます
  2. 構成の指針として、story_structures.md を参照します
  3. 第2幕で必要な要素(状況の悪化、中盤の転換点、高まる緊張感)を確認します
  4. キャラクターアークに沿って、ビートごとのアウトラインを作成します
  5. プロットとキャラクターアークがどのように交差するかを記します
「物語に矛盾がないか確認して」
  1. consistency_checker.py スクリプトを実行します
  2. 出力を確認して問題点を特定します
  3. 矛盾を理解するため、指摘されたファイルを読みます
  4. 問題ごとに具体的な修正案を提示します
  5. ユーザーが確認した場合は、編集を申し出ます
「物語の時系列を整理して」
  1. timeline_tracker.py スクリプトを実行します
  2. 出来事の順序を示す出力を確認します
  3. 時系列の抜けや矛盾を特定します
  4. 抜けている箇所に時系列マーカーを追加することを提案します
  5. キャラクター別または章別に整理した時系列の概要を提示します
「スリラーにはどんな構成を使えばいい?」
  1. 参考資料の story_structures.md を参照します
  2. 三幕構成または「Save the Cat」を提案します
  3. 緊張感の高まりやタイムリミットなど、スリラー特有の要件を説明します
  4. 物語のアイデアに合わせたビートシートを提示します
  5. 詳細なプロット計画書の作成を申し出ます

リソース

scripts/timeline_tracker.py

Markdown ファイルを分析し、時系列上の出来事を抽出して整理する Python スクリプトです。キャラクターの登場を追跡し、時間を示すマーカーを特定し、出来事を時系列順にまとめ、整合性の問題を指摘します。

使用方法: プロジェクトのルートから python3 .claude/skills/storyboard-manager/scripts/timeline_tracker.py . を実行します

scripts/consistency_checker.py

すべてのストーリーファイルを対象に、キャラクターの設定、身体的特徴、年齢、名前、世界設定の事実に矛盾がないかを検出する Python スクリプトです。重大度順に、問題のあるファイルの場所を出力します。

使用方法: プロジェクトのルートディレクトリから python3 .claude/skills/storyboard-manager/scripts/consistency_checker.py . を実行します。

references/character_development.md

多面的なキャラクターを作成するための包括的なフレームワークです。中核となる要素、バックストーリーの構成、キャラクターアークの種類、関係性の力学、話し方の形成、一貫性に関するガイドラインを取り上げています。

読み込むタイミング: 新しいキャラクターの開発、既存のプロフィールの強化、キャラクターの一貫性に関する問題の解決、キャラクターアークの計画を行うとき。

references/story_structures.md

主要なストーリー構造(三幕構成、ヒーローズ・ジャーニー、Save the Cat)、キャラクターアークのテンプレート、シーン構成、ペース配分のガイドライン、プロットの展開手法、ジャンル別の構成を網羅した詳細なリファレンスです。

読み込むタイミング: ストーリーのアウトライン作成、幕の構成、プロットの要点の整理、ペース配分の決定、特定の物語フレームワークの適用を行うとき。

コメント