Communitygithub.com

long-video-story

長尺動画のストーリーをユーザーと合意します。ユーザーがストーリーを提供するか、Claudeに作成を依頼します。Claudeが作成する場合は、まずストーリースタイルを選択し、該当するスキルを実行してから、ユーザーが承認するまで修正を繰り返します。

long-video-story とは?

このスキルは、長尺動画ワークフローの第2ステージです。プロジェクトフォルダに`story.md`(承認済み)を出力するまで、次のステージに進みません。ユーザーがストーリーを持ち込んだ場合はそのまま保存し、Claudeに作成を依頼する場合は、まずストーリースタイル(`niche`、`questions`、`open`など)を選択させ、対応するスキルを呼び出してトピックを決定、その後ライタースキルを実行してストーリーを生成します。`open`スタイルの場合は、デフォルト構造(タイトル、ログライン、フック、アウトライン、全文、結末とCTA、要検証項目)に従って執筆します。承認プロセスでは、ユーザーが明示的に「承認」と言うまでループし、変更要求や別のストーリー希望にも対応します。最後に`story.md`のステータスを`approved`に更新し、`project.json`のステージを`story-approved`に設定します。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/samanfirouzi/long-video-skill/tree/HEAD/skills/long-video-story

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

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

ドキュメント

長尺動画のストーリー

長尺動画ワークフローの第2ステージ。出力: プロジェクトフォルダ内の承認済みstory.md。

このステージは、Claudeとユーザーがストーリーに合意した場合にのみ終了します。それ以前に後のステージは開始されません。

開始前の準備

  1. アクティブなプロジェクトを検索: ~/.long-video/projects/<slug>/project.json。ユーザーが複数持っている場合は、どれかを尋ねてください。
  2. プロジェクトが存在しない場合は、最初にlong-video-setupを実行します。
  3. ~/.long-video/configs/<config-name>.jsonからプロジェクトの設定を読み込みます。長さ、言語、オーディエンス、トーン、フォーマット、ビジュアルアプローチに使用します。設定で回答済みの質問を再度尋ねないでください。
  4. story.mdがすでに存在し、ステータスがdraftの場合は、続行を提案します。ステータスがapprovedの場合は、再開するかどうかを尋ねます。

ステップ1: エントリー質問

「ストーリーはお持ちですか?それとも私に書かせますか?」と尋ねます。

  • ストーリーを持っている ユーザーがストーリーを貼り付けるか説明します。ステップ5へ進みます。
  • 書いてほしい ステップ2へ進みます。
  • ざっくりしたアイデアがある ユーザーがシード(トピック、テーマ、一行)を提供します。それを保持し、ステップ2へ進みます。

ステップ2: ストーリースタイルを尋ねる

Claudeがストーリーを書く場合は、必ずこれを尋ねます。スキップせず、ユーザーに代わってスタイルを選択しないでください。

  1. references/story-styles.mdを読みます。どのスタイルスキルがインストールされているか確認します。
  2. 利用可能なスタイルを、それぞれの一行説明とともに表示します。必ずopenを含めます。
  3. ユーザーに一つ選んでもらいます。ユーザーが独自のスタイルを説明することもできます。その場合は、その説明を追加指示としてopenとして扱います。
  4. 選択をproject.jsonに"story_style": "<id>"として保存します。

ステップ3: トピックを取得する

選択されたスタイルのタイプに従います。

  • ideas(例: niche): スタイルスキルを呼び出します。設定の概要とシードを渡します。トピックが返されます。次に、使用するライターを尋ねます(レジストリのステップ4のペアリングルールに従います)。
  • writer(例: questions): ユーザーがトピックまたはシードを持っている場合はそれを使用します。ない場合は尋ねます。トピックを提案しないでください。
  • open: 以下に従ってアイデアを提案します。

Openスタイル: アイデア提案

  1. シードがない場合、最大3つの短い質問をします: トピック領域や興味、避けたいこと、使用する実際のイベントや情報源。
  2. 設定に合った4つの提案を書きます。各提案には: タイトル、一文のログライン、最初の15秒をフックとして、このオーディエンスに合う理由。
  3. 4つの提案が互いに明確に異なるようにします。
  4. ユーザーに一つを選ぶか、2つを組み合わせるか、追加を求めるか、新しい方向性を与えるよう促します。ユーザーが選ぶまで繰り返します。

ステップ4: ストーリーを書く

ライターを呼び出します。

  • ライタースキル(例: long-video-story-questions): トピック、目標時間、言語、設定の概要を渡して呼び出します。このスキル自体の出力形式が優先されます。デフォルト構造に整形し直さないでください。
  • open: 以下のデフォルト構造で書きます。

デフォルト構造(openスタイル)

設定の目標時間に合わせます。話し言葉は1分あたり約150語で進むため、15分の動画には約2250語の話し言葉が必要です。今は最終的なスクリプトを書かないでください。ストーリーを書きます: 何が起こるか、順序、ユーザーが判断するのに十分な詳細を含めて。

  1. タイトル(仮)
  2. ログライン
  3. フック 冒頭15〜30秒
  4. ストーリーアウトライン 幕または章。それぞれ: 何が起こるか、転換点、ランタイムのおおよその割合
  5. 全文 散文で最初から最後まで
  6. 結末と行動喚起
  7. 要検証項目 情報源が必要な事実の主張をすべてリストアップ。純粋なフィクションの場合は「なし」と書く

openスタイルのルール:

  • ノンフィクションストーリーで事実を創作しない。「要検証項目」に不明な点を記す。
  • 既存作品をコピーしない。独自の構造と表現を使用する。
  • 設定の言語とトーンを保つ。

下書きを保存する

次のヘッダー、ステータスdraftでstory.mdに保存:

---
title: <仮タイトル>
status: draft
revision: 1
style: <スタイルID>
writer: <ライターIDまたは"open">
config: <設定名>
---

テキストをヘッダーの下に配置します。チャットでストーリーを表示します。

ステップ5: 確認または修正

ユーザーがステップ1で独自のストーリーを持ち込んだ場合、まず上記のヘッダー(style: user)でstory.mdとして保存します。

承認するか、変更をリクエストするかを尋ねます。ストーリーの後に新しいメッセージで質問します。ライタースキルの出力内に質問を入れないでください。

  • 変更リクエスト 適用します。ライタースキルがテキストを作成した場合、そのルール(形式、トーン、正直さ)を編集時にも守ります。revisionを増やします。2〜3行で何が変わったかを示し、更新されたストーリーを表示します。再度尋ねます。
  • 質問や疑問 回答します。回答が問題を示す場合は、変更を提案します。
  • 別のストーリーを希望 ステップ2に戻ります。古いファイルをstory.rev<N>.mdとして保持します。
  • 承認 明示的な「はい」が必要です。沈黙、「今のところよさそう」や「でも…」は承認ではありません。不明な場合は、直接一つ質問します:「このストーリーを確定しますか?」

承認されるまでループします。ユーザーを急かさないでください。

ステップ6: 確定

  1. story.mdのフロントマターでstatus: approvedに設定します。approved: <ISO日付>を追加します。
  2. project.jsonを更新: "stage": "story-approved"に設定します。
  3. ユーザーにファイルパスを伝えます。ストーリーステージが完了したことを伝えます。
  4. long-video-assets(キャラクター、環境、オブジェクト、スタイル)に進むことを提案します。ユーザーが同意した場合のみ開始します。

ルール

  • 明示的な「はい」なしにストーリーを承認済みとマークしないでください。
  • 承認済みのストーリーを黙って変更しないでください。再開にはユーザーのリクエストが必要で、ステータスをdraftに戻します。
  • Claudeがストーリーを書くときは、スタイルの質問をスキップしないでください。
  • インストールされていないスタイルスキルを呼び出さないでください。
  • 提案や修正は簡潔に保ちます。全文表示はストーリー自体のみで行います。

Individual skills in this repo

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

long-video-assets

Video and animation skill. Build the visual foundation for a long video from an approved story. Extracts the recurring characters, environments and key objects, helps the user choose one art style from suggested options (10 at a time, more on request), then writes image generation prompts for every character (portrait plus character sheet), environment and object, all sharing one locked style. Can also generate the images (installed tool, API, MCP or browser) or hand the user a folder and file names to fill. Use after lon

long-video-director

Turn an approved story into a shot-by-shot video script, acting as the director. Asks whether the video uses a narrator or characters who speak (or both), suggests professional filming choices (camera type, lenses, camera movement, lighting, color, pacing), saves them as a separate film style file, then writes a script that matches the project config. Outputs film-style.md and video-script.md. Use after long-video-story (and long-video-assets) are done, or when the user asks for the video script, shot list, camera style or lighting plan.

long-video-keyframes

Create the start and end frame image for every scene (clip) of the approved video script. Writes one image prompt per frame with a fixed file name that holds the scene number and start or end, makes a folder for the images, and can generate the images with an available image tool, or hand the prompts to the user all at once or one by one. Use after long-video-director, or when the user asks for start frames, end frames, keyframes or scene images.

long-video-render

Assemble the finished video and run the review loop. Builds the edit from the clips (or images with camera moves), voice, sound stems and captions, renders a low quality review version with scene numbers and time burned in so a client can review it, collects and applies changes (re-rendering reviews as often as needed), and when the user approves, renders the high quality final video. Uses a video editor with a CLI or MCP (FilmCraft, EffectCraft or another) if one is available and the user wants it, otherwise the bundled ffmpeg renderer. Use after long-video-sound, or when the user asks to render, assemble, export, preview or finalize the video.

long-video-sound

Video and animation skill. Create the sound effects, ambience and background music for the video and place them on the timeline. Plans the sound design from the approved script, sources or makes each sound (Openverse for openly licensed recordings and music, Earshot to make sounds from words and to listen to and judge sounds, Clipwing real-sfx to place real sounds on exact frames), records licences and credits, and mixes separate stems (effects, ambience, music) with the music ducked under speech. Or gives the user a fold

long-video-voice

Create the spoken audio (narration and character voices) for the approved video script. First decides whether the video needs speech and asks the user to confirm. If yes, builds a voice cast (narrator plus each speaking character), makes a short sample of each voice with an available tool such as an ElevenLabs MCP and asks the user to approve the voices, then generates one audio file per spoken line with a name that holds the scene number and speaker. Or gives the user the lines, file names and folder to record or generate themselves. Use after long-video-clips (or long-video-keyframes), or when the user asks for narration, voiceover, voices or dialogue audio.

関連スキル