Communitygithub.com

CrissAlvarezH/video-script

クリエイター自身の動画分析データを活用して、視聴者を引きつける短尺動画のスクリプトを作成します。アイデアのフック選び、撮影前のスクリプト作成・推敲、投稿済み動画の分析に基づく改善点の抽出に使用します。アイデア出しはcontent-ideasが担当します。

video-script とは?

このスキルは、短尺動画(ショート動画)のスクリプト作成とレビューをクリエイターの実際の分析データに基づいて支援します。主な機能は「Script(スクリプト作成)」と「Review(投稿済み動画の分析)」の2つです。「Script」では、フック、2文目、証明という3つの重要な選択を、クリエイター自身の過去動画のデータ、プラットフォームの公式情報、最後に直感の順でエビデンスに基づいて行います。スクリプトは視聴者の好奇心を維持しつつ、答えを与えすぎないバランスが重要で、時間経過に合わせた構造(0〜3秒のフック、3〜10秒の2文目、答えを遅らせる中間部、最終的なペイオフ)を厳密に守ります。「Review」では、投稿済み動画の分析データ(視聴回数、維持率曲線など)をキャプションと照合し、改善点を特定、次のバージョンへの提案を行います。このスキルは、自身のデータを活用して動画パフォーマンスを継続的に向上させたいYouTuberやコンテンツクリエイター向けで、Claude CodeやCodexなどのAIエージェント環境で動作し、SKILL.mdに定義されたルールとチェックリストに従って動作します。アイデア出しはcontent-ideasスキルと連携します。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/CrissAlvarezH/ai-reel-gen-app/tree/HEAD/.claude/skills/video-script

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

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

ドキュメント

動画スクリプト

短尺動画は、撮影前の3つの選択によってほぼ決まります。すなわち、ステーク(関係者以外で、気にかける理由がある人)、最初の2文(なぜ見続けるのか)、**証拠(視聴者が目にして主張を現実だと感じるもの)**です。それぞれの選択はエビデンスに基づいて行います。まずクリエイター自身の過去動画、次にプラットフォームの公式発表、最後にセンスです。

視聴者が観るのは、ある質問への答えです。好奇心が視聴者を引きつけ、それぞれの答えは離脱の理由を与えます。したがって、スクリプトはこの2つのバランスです。早い段階で質問を開き、別の質問が開かれていない限り閉じてはいけません。

セットアップ

SKILL_DIR はこのスキルのフォルダを意味します。~/.video-script/profile.md が存在すればそれを読み込みます。そこには、クリエイターの動画ライブラリ、分析結果ファイル、プラットフォームのメモ、声とペースが記載されています。何かを提案する前に、分析結果ファイル(まだ実行中のテストを含む)とライブラリインデックスを読み、アイデアが類似する過去動画を引用してください。分析結果が以下のデフォルトと矛盾する場合、分析結果が優先されます。それらはこのオーディエンスで測定されたものだからです。

プロフィールがない場合、プラットフォーム、オーディエンス、および好調だった過去動画と不調だった過去動画(数字付き)を1回だけ尋ねてください。その後、ライブラリ形式に従ってプロフィールとライブラリを作成することを提案してください。

目標とは、動画が構築される目的です。リーチ(フォロワー以外からの視聴)、フォロー、保存、シェアのいずれかです。リクエストで指定がない場合はリーチを想定し、その旨を伝えてください。

ここでのタスクは Script(スクリプト作成) と Review(投稿済み動画のレビュー) です。アイデアはcontent-ideasに任せます。このスキルはスクリプトまたはレッスンで終了します。撮影はクリエイター、編集はvideo-edit、アニメーションはanimated-videoの担当です。

アイデア

アイデアを考えて保存するのはcontent-ideasの担当です。アイデアからスクリプトを開始する場合、そのノートにはすでにフック、開かれる質問、保留される内容、証拠が記載されています。それらを出発点とし、ソースと照合してから依存してください。

スクリプト

アイデアを1文で述べ、その目標も併記してください。2文必要なアイデアは2本の動画です。どちらを先に作るか尋ねてください。

フックの前に、ペイオフと最も強力な証拠を見つけてください。次にフックを2つの部分で書きます。トピックを、このオーディエンスが望む結果として、彼らの言葉で問題について述べます。次に、あなたが持つ最も驚くべき真実の主張または証拠を述べ、視聴者が言葉にできる質問を開きます。その質問に答えることになる場合は、主題を名指ししないでください。クリエイターのペースで(プロフィールから、デフォルトは毎秒3語)ドラフトを作成します。3つの瞬間は時間に結びついており、その間の部分は1つのルールに従います。残りはストーリー独自の形を取ります。

  • 0~3秒、フック:視聴者のステークまたは画面上の何かについて。クレデンシャルは後で、信じる理由として登場します。視聴者が望む結果は、質問を開く場合にステークとしてカウントされます。
  • 3~10秒、2文目:フックのステークを高めるか、その質問を鋭くしますが、答えは与えません。避けられる離脱のほとんどはここで発生するため、背景は後回しにします。背景とは、視聴者が後の詳細を追うためにのみ必要なもの(歴史、誰であるか、仕組みなど)です。テスト:15秒以降に移動しても最初の15秒で何も失われない場合、それは背景です。
  • その間、答えは保留される:ペイオフは一度に与えられるものではありません。フックの質問を閉じるラインを特定します。多くの場合、視聴者が認識する用語です。一度聞けば残りを知ったと思うでしょう。その前に、そこに至るまでにそれ自体で聞く価値のあるもの(多くの人が間違えること、それが彼らに与えるコスト、明白な代替案が失敗する理由)を配置します。ついにそれが語られたとき、同じ息で新しい質問が開かれます。彼らがまだ聞いたことのない何かについてです。保留とは、その間彼らに何か他のものを与えることです。単に焦らしたり「最後まで見て」と言うだけのラインは保留ではなく、フィラーです。
  • 終わり:最終的なペイオフ、フックの約束を画面上で示し、その後最大1つの短いコールトゥアクションを置きます。ペイオフの後に続くものは、離脱するオーディエンスに対して再生されます。

解説動画(何かの仕組みを説明する)の場合、ドラフト前にexplainersを読んでください。

すべての行の横に、視聴者が見るものと、それに必要なキャプチャ(スクリーンレコーディング、ドキュメント、実際の人物や製品)を書いてください。誰も描けないラインは、視聴者が頭の中で保持しなければならないラインです。アニメーション動画の場合、この列はanimated-videoへのメモであり、世界をデザインします。

納品し、プロフィールの指定場所に保存します。スクリプトは時間、話すライン、画面上の画像として。キャプチャリスト。話すスクリプトでは伝えられない注意事項やリンクを含むドラフトキャプション。その冒頭はフックの質問に答えるのではなく、それを高めます。推定実行時間。まだ決まっていない場合の代替フック(それぞれに独自の2文目)。検証すべき主張とそのソース(開けなかったソースはフラグを立ててください)。新しいエージェントに、スクリプト内の各主張をソースに対してそのまま確認させてください。正しいリサーチでもスクリプトでは誇張される可能性があります。

クリエイターが一部の行を書き直した場合、あなたがまだ所有している行に文体の違いを反映させてください。編集を依頼されない限り、彼らの表現を維持し、事実上の問題は別途報告してください。

チェックリスト

納品前に、以下の点、分析結果ファイル、プラットフォームのメモに対してスクリプトを確認してください。

  • 1つのアイデア。リスト形式の内容は、各項目がそのアイデアを証明する場合にのみ価値があります。
  • ステークは、それが誰に影響し、彼らが何を望むかによって、非専門家が理解できる言葉で枠付けされています。ツール名や専門用語は、視聴者が気にかける理由を持った後に登場します。
  • 視聴者として読む。各行で、もう答えを知ったと感じて離脱するかどうかを自問してください。計画したポイントより前にそう感じる場合は、その行を移動するか、そこで次の質問を開いてください。フックの質問を閉じるものとそのタイミングを明示してください。
  • すべての主張が示されています。音声、キャプション、画面が同じ数字を示しています。
  • フック内のすべての約束が画面上で果たされています。
  • すべての文は、単独で読んだときに、誰が何を何にし、結果がどこに行くかを示しています。省略された目的語や曖昧な参照は名詞に置き換え、指示対象が明確な代名詞はそのままにします。改訂はこれを壊すので、改訂のたびに再確認してください。
  • 行は、クリエイターの声(プロフィールで指定された音声ガイド)で、完全でつながった文であり、声に出して言いやすいものです。非常に短く切られて質問を投げかける行(「完全なルート」とは何の?)は、節約する秒数以上のコストがかかります。
  • 各行がストーリーを前進させます(前の行を言い換えたり、これから来ることを予告するだけの行は前進しません)。実行時間はストーリーが許す限り短くします。

投稿済み動画のレビュー

  • すべての数字を記録します。視聴回数、視聴者数、平均視聴時間、フォロー数、インタラクション数、各割合とそのラベル、ソース別視聴回数、保持率曲線とその時間です(インサイトの読み方)。スクリーンショットから、python3 SKILL_DIR/scripts/retention_curve.py SHOT --duration SECONDS で曲線を読み取り、その面積ベースの平均をアプリの数値と照合してください。各スクリーンショットの動画を、サムネイル、グラフの日付、視聴回数から特定します。その証拠で判断できない場合は質問してください。
  • 曲線を最終レンダリングのキャプションと照合します。すべての崖と高原について、その数秒前に言われたことと表示されたものを記録します。ライブラリと比較します。同じフォーマットの動画、および全動画の3→10秒のドロップを比較します。
  • 価値のある次のバージョンがある場合、それを特定します。見つけた問題に対処する最小の変更(新しいフック、視聴者が離脱した箇所のカット、他を上回った動画が異なる方法で行ったこととその再現方法など)を提示します。
  • 動画のライブラリエントリとインデックス行を作成し、分析結果ファイルを更新します。各仮説に触れるエビデンスを追加し、2本以上の動画が一致した場合にのみステータスを変更します。保存する前に、引用されたすべての行と時間をキャプションファイル(要約ではなく)から取得し、投稿日はそのソースとともにのみ提供し、すべてのランキング語(最高、最低、唯一、最良)を、カバーする動画にスコープを絞ってインデックスと照合してください。

Individual skills in this repo

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

CrissAlvarezH/animated-video

Make animated videos in code with Remotion (React, SVG, three.js): explainers, character stories, motion graphics, kinetic typography, paper collage and animated infographics, in 2D or 3D, from a script or voiceover, in any aspect ratio. Use when asked to animate a script, make an animated video or Reel, or motion graphics. Not for editing camera footage (video-edit) or AI-generated clips (higgsfield-*).

CrissAlvarezH/new-style

Create a new visual style for the creator's videos in a Reel Studio workspace (styles/<id>/style.json): interview him for its name, feel, colours and what each one means, fonts, motion, where pictures come from, reference links and images, then write the style so it shows in Estilos and new videos can use it. Use when he asks for a new style or presses "Nuevo estilo" on the Estilos page.

CrissAlvarezH/persona-hablando

The "Persona hablando + animaciones" format of a Reel Studio video — the creator talks to camera in his own recording; you transcribe it, agree the cuts with him (pauses, flubs, retakes), cut it, and lay the video's style animations over or between his shots. Use for any video whose format.txt says persona-hablando.

CrissAlvarezH/reel-studio

How a narrated explainer video is made in a Reel Studio workspace, in any visual style — script, pictures, voice, images, build, board, sound, mute test, render — following the creator's settings from the studio (profile, format, voice, image sources). Use for any new or revised video in a project's videos/ (projects/<id>/videos/). The video's style adds its own skill (styles/<id>/SKILL.md) for the look and the Remotion kit; LESSONS.md has what past videos taught.

関連スキル