Communityライティング&編集github.com

スクリプト

ユーザーの声(voice.md)でエピソードの台本を書き、テレプロンプター形式に整えます。タイトルとプルーフが確定した後に、約束を届けるオープニング、小さなストーリー、批判的な側面、独自の形の判定、チャンネルのクロージングラインまでを構成します。

スクリプト とは?

このスキルは、エピソードのナレーション台本をユーザーの自然な話し声で作成するためのものです。タイトルとサムネイルが確定した後にのみ使用し、プルーフ(根拠)に基づいた数字や引用のみを使用します。台本はテレプロンプター用に整形され、段落は呼吸の単位、太字はキーワード、3行の空行は編集カットポイントとして機能します。最終的な台本はスクリプトチェッカー(script_check.py)で自動検証され、フォーム、文の長さ、オープニングとエンディング、数字の正確性、全体の長さが厳密にチェックされます。また、Humanizerパスを経て、ユーザーの声にさらに近づけられます。対応プラットフォームはCrewCut(Webテレプロンプター)、Claude Code(humanizerスキルとして)、Codex(プロンプト内テキスト)です。

対応✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/marcopatzelt/crewcut/tree/HEAD/skills/script

Installed? Explore more ライティング&編集 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

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

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

ドキュメント

スクリプト は何をしますか?

ライターは、ユーザーが動画で話す内容を書きます。目標:ユーザーが一度読んで録音すること。すべての文は、タイトルとサムネイルの約束を伝えるか、証明する必要があります。

書き始める前に

  1. タイトルとサムネイルのテキストが承認済みであること(brief/TITLE-vNNN.md)。タイトルがなければスクリプトはありません。
  2. プルーフ(根拠)が承認済みであること(brief/PROOF-vNNN.md)。数字、経験、引用を決して捏造しないでください。何か不足している場合は、書く前にチャット(crewcut say)で質問してください。スクリプトにギャップやプレースホルダーがあってはなりません。
  3. voice.md(ユーザーの話し方、使用・回避すべき単語)、brand/rules/script.md、および edit-style.json 内の長さ(length_minutes)と channel.json 内の話速(script.words_per_minute)を読んでください。
  4. 最後の3つのスクリプトのエンディングを読んで、この判定が新しい形になるようにしてください。

構成

2つの形式があります。ツールや主張にはテスト形式を、何かが起こった場合(詳細は references/forms.md)にはストーリー形式を使用します。

  1. オープニング、2〜6文。 最初の数秒で約束とその数字を伝えます:文1はツールまたはトピックとその主張を述べます。挨拶、質問、「この動画では」は不要です。最初の30秒でクリックを確定します:視聴者は、タイトルとサムネイルが約束した動画を手に入れたと認識します。未解決のループは最大1つで、最後に解決します。
  2. 問題点、視聴者が知っているケースで提示します。未知のツールが最初に出てきたときに説明します。
  3. その機能、視覚的に、視聴者がまだ知らないことだけを説明します。
  4. 独自のテスト、実際の数字を使用し、人が話すように丸めます。ツールが本来作られた目的のテストのみを行います。
  5. チャンネル登録の1行、最初の強い結果の直後に配置:視聴者がチャンネルから得られるもの。ベンダーがテスト費用を支払っていない場合は、その行でその旨を述べます。決して最初に置かず、最後に懇願する形でも置きません。
  6. 段階的に高まる利害関係を持つ小さなストーリー。 オープニングと判定の間の各ブロックには、目標、障害、解決策があります。ブロックが進むにつれて利害関係が高まります(より多くのデータ、より多くの資金、より難しいテスト)。最も強いテストは判定の直前に最後に来ます。オープニングでそれを予告することはできますが、明かしてはいけません。
  7. 批判的な側面。 ベンダーの数字と独自または独立した測定値の比較、限界。ツールが約束を守れない場合はその旨を述べ、タイトルはタイトルステップに戻ります。
  8. 判定、毎回独自の形式で:視聴者への課題、残る唯一の数字、それがユーザー自身の仕事にとって何を意味するか、オープニングのイメージへのコールバック。固定されたクロージング質問ではありません。
  9. エンディング。 channel.json にオファーや必須言及(script.end_mentions)がある場合、それは最後の文に、ユーザーの言葉で含めます。最後の文は、チャンネルの closing_line がある場合はそれです。

比較動画: 同じ構成のブロックを2つまで連続させ、3つ目は形式を変えます。中間地点に新しいフックを入れます。各ステートメントは1回だけ。すべての候補のコストと時間はまとめて、画面上に、各ブロックの最後ではなく一度だけ表示します。

言葉遣い

  • voice.md からのユーザーの言葉を使用し、その回避リストにある言葉は決して使いません。
  • 短い文:中央値で約10〜12語、決して script.sentence_max_words を超えません。
  • 1文に含める製品名は最大3つまで。より長いリストは画面上に表示します。
  • 除外:視聴者が既に持っている基本的な知識、誰も気にしない詳細(テスト回数、内部スイッチ)、ファイル名、コマンド、サイドトピック、個人名、例を選んだ理由、約束の一部ではないコスト。
  • 広告や販売のトーンは禁止:テストしたことを述べ、視聴者に何も約束しません。オープニングで壮大な「これではなく、あれ」のような言い回しはしません。
  • ビジネスは、視聴者のビジネスに語りかけるのではなく、例を通して示します。

テレプロンプター形式

ユーザーはカメラの横にある電話から読み上げます。

  • ライン --- より上には話すテキストのみを配置します。編集用のメモ(シーン、クリップ、各数字の出典)はその下に置きます。
  • 段落は1呼吸分:1〜 script.paragraph_max_sentences 文。1行の空行は短い間。
  • 3行の空行はパートを区切ります:そこで編集がカットでき、テレプロンプターがページ送りし、クリップを流せます。
  • 括弧、ステージノート、見出し、チャプター、タイムスタンプ、タイトル行は使用禁止。ダッシュはパックが許可している場合のみ使用可。
  • 段落のキーワード1〜2個を 太字 でマークします。テレプロンプターのポイントモードでは、全文の代わりにこれらが表示され、自由に話したいユーザーをサポートします。

手順

  1. 証明された数字で構成を埋めます。
  2. カット:すべての文が約束を伝えるか証明することを確認します。
  3. ユーザーの声に変換します。頭の中で一文一文読んでください:ユーザーはこれをカメラに向かって言うでしょうか?
  4. 下書きを work/script-draft-vNNN.md に次の空き番号で書き込みます。決してバージョンを上書きしないでください。
  5. ヒューマナイザーパス(下記参照)。結果を brief/SCRIPT-vNNN.md(同じ番号)に書き込み、次に記録します: crewcut humanize record --draft work/script-draft-vNNN.md --final brief/SCRIPT-vNNN.md --why "<適用されたパターン>"。
  6. エラーが0になるまでチェック: python3 skills/script/scripts/script_check.py brief/SCRIPT-vNNN.md --title "<タイトル>" --name "<ツール>" --proof brief/PROOF-vNNN.md。すべての警告とヒントを読みます。残すヒントには、--- の下に一文の理由を記述します。チェックを通すためにスクリプトを変更した場合は、再度記録を実行します:カードには正確なファイルの記録が必要です。
  7. カード:crewcut card propose --episode <id> --step script --kind script --title "Script, version N" --file brief/SCRIPT-vNNN.md --body "<単語数>, 約 <分> 分, チェック: 0 エラー"、次に crewcut card wait。カードには「Humanized」と変更内容が表示されます。記録がない場合は拒否され、実行すべきコマンドが表示されます。
  8. 承認後:crewcut prompter <id> で電話リンクとQRコードを表示します。ユーザーに1つのメッセージで伝えます:リンク、パート数、およその長さ。テレプロンプターには --- より上のテキストのみが表示されます。

ヒューマナイザーパス

すべてのスクリプト下書きは、ユーザーが目にする前にヒューマナイザー(blader/humanizer、MIT)を通過します。長尺動画もショートも同様です。CrewCutは起動時に最新バージョンをダウンロードします。Claude Codeでは、スキル humanizer:humanizer(他のスキルと同様に実行)として利用可能で、Codexではそのテキストがプロンプトに含まれます。crewcut skills status でバージョンを確認できます。

  • モード「埋め込み」、ユーザーの声を使用。 最初に brand/voice/ 内のすべてのファイルを読みます:ユーザー自身の動画からの実際の話し言葉。これらを音声サンプルとしてヒューマナイザーに渡します。サンプルがない場合はプレーンモードで、カードにその旨が表示されます。
  • 最も注意すべき点: 「XではなくY」という対比構造;新しい情報を追加しないクロージングライン;深そうに聞こえることわざ;本題に入る前のわざとらしい前置き(「ここがポイント」);3つのリスト;誇張された意味や広告的な言葉遣い。
  • 保持すべきもの: ヒューマナイザーが滑らかにしようとしても、ユーザー自身の言葉や言い回し(brand/voice/ および voice.md にあるもの);すべての数字、名前、主張、タイトルの約束。このパスは聞こえ方を変え、内容は決して変えません。
  • 範囲外: テキストをAI検出器にかからないようにすること。ヒューマナイザーは人のために編集し、私たちもそうします。

チェックが見られないもの

例が広くなりすぎていないか、一部が本筋から逸れていないか、テストが約束に適合しているか、声がユーザーらしく聞こえるか。これらは手順2と3での読み取り作業です。

計画中

  • キューシートとパートごとのテイク2回(1回目はキューシートなしで自由に、2回目はスクリプトから;編集は良いテイクを採用):形式は references/forms.md に記載。チェッカーとテイクミックス(スタジオの zettel.py)はまだ移植されていません。
  • スクリプトと録音の比較:承認されたスクリプトを文字起こしと比較して、ユーザーの実際の言葉を学習します(これらの文字起こしは新しい音声サンプルになる可能性があります)。
  • voice.md 内のデータとして、言語ごとのフレーズチェックリスト(フィラーワード、販売フレーズ)。

出典

Individual skills in this repo

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

edit

Builds a video version from the user's recording: the speaker cut, then one edit plan with all inserts (2D scenes, 3D scenes, recordings, keywords), sound and music, built with one command (crewcut render). Use for: edit the video, build the cut, speaker cut, rough cut, insert, b-roll, 2D scene, 3D insert, counter, keyword, music bed, sound, assemble, render the preview, new plan version, short from the long video.

shorts

Makes YouTube Shorts in two modes: Clip (cut from a finished episode: candidates from the transcript and retention, a 9:16 rough cut from the original recording around the face, portrait graphics, music with clear rights, the Critic's own Short check) and Original (a Short recorded for itself: three ideas with a proof from the user's real work, the user talks freely, the Writer shortens, only the speaker is recorded, the crew brings the B-roll). Publishing: one card per Short, or the user's own standing approval for Shorts; at most two a day. Use when: \"make shorts\", \"make a short about …\", \"clip this episode\", \"short from episode N\", \"publish shorts without asking\", \"how are my shorts doing\". Not for long videos (skills/episode, skills/edit).

title

Writes and checks the YouTube title and the thumbnail text of an episode, before the script. Delivers five candidates with a hook and a reason each, one recommendation, and three variants for the A/B test; skills/title/scripts/title_check.py checks every candidate against the style pack. Use when: \"title\", \"video title\", \"YouTube title\", \"what should the video be called\", \"check this title\", \"shorten the title\", \"better title\", \"thumbnail text\". Not for the blog's search title and not for the thumbnail image.

関連スキル