Communitygithub.com

elkl111/リール編集ラボ ベータ版

リール編集ラボの初回セットアップ。不足しているものをインストールし、簡単なブランドインタビューを行い、ユーザー自身の映像でルックを選び、キットとして保存します。「セットアップして」「始めて」「オンボーディングして」といったユーザーの発言や、ブランド/kit.txtがまだ存在しない場合(ラボがセットアップされていない場合)に使用します。

リール編集ラボ ベータ版 とは?

このスキルは、リール編集ラボを初めて使用する非技術系ユーザー向けの完全なオンボーディング体験を提供します。依存関係のインストール、ブランドインタビュー、ユーザー自身の映像を使ったルックの選択、そしてパーソナライズされたキットの保存を自動化し、ユーザーが最初のリールを編集できる状態にします。Claude Code環境向けに設計されており、Homebrew、ffmpeg、Pythonツール、Playwright、音声モデルなどの必要なソフトウェアを順次インストールします。インストール中はユーザーに進行状況を説明し、コマンドライン操作を最小限に抑えます。ブランドインタビューでは、エネルギーレベル、ブランドの好み(色、フォント、インスピレーション画像)、および避けたい要素を収集し、これらをブランドプロファイルに保存します。その後、サンプルクリップを使用して複数のルックを生成・表示し、ユーザーが選択したルックにブランドの好み(色、フォント、スタイルルール)を適用してカスタムキットを作成します。キットは再利用可能で、将来のリール編集に自動的に適用されます。このスキルは、ユーザーにコマンドを実行させず、すべての操作をチャットインターフェース内でガイドすることで、スムーズなセットアップを実現します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/elkl111/reels-editing-lab-beta/tree/HEAD/.claude/skills/setup

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

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

ドキュメント

セットアップして

ユーザーがラボを初めて開いた状態です。技術に詳しくありません。最終的には、すべてがインストールされ、自分の顔で確認して選んだルックと、保存された自分のキットが揃います。これで最初のリールを作成する準備が整います。

トーン: 温かく、簡潔に、一度に一つのステップ。待っている間は何が起こっているかを伝えてください。生のツール出力をそのまま貼り付けないでください。コマンドを実行するように依頼しないでください(Homebrewが不足している場合の1行を除く。ステップ1参照)。

最初に短いメッセージを1つ送信します:

リール編集ラボへようこそ。セットアップには約10分かかります:いくつかのものをインストールし、3つの簡単な質問をし、あなたの動画でルックを選びます。始めましょう。

1. インストール (約5分、ほとんどは音声モデルのダウンロード)

python3 tools/doctor.py を実行します。チェックリストと DOCTOR=ok または DOCTOR=missing:<名前> を表示します。不足している項目を次の順序で修正し、最後に doctor を再実行します:

  1. mac / space: いずれかが失敗した場合は、停止して親切に説明します(Appleチップ搭載Macが必要、約6GBの空き容量が必要)。
  2. homebrew: ユーザーの代わりにインストールすることはできません。実際のターミナルでMacパスワードが必要なためです。理由を1行で説明し、doctorの修正から正確な行を提供し、ターミナルアプリを開くように指示します(Cmd+Space、Terminalと入力)。貼り付けて、Enterキーを押し、Macパスワードを入力し(入力中は何も表示されません。正常です)、プロンプトに従うよう伝えます。最後にHomebrewが echo と eval で始まる2行の「Next steps」を表示するので、それらも貼り付けるように依頼します。完了したと言われるまで待ち、再確認します。
  3. apple-tools: xcode-select --install を実行します。Macのウィンドウがポップアップするので、インストールをクリックし、完了したら知らせるよう伝えます(数分かかります)。Homebrewが通常これらをインストールするので、最初に確認します。
  4. ffmpeg: brew install ffmpeg(brew がまだパスにない場合は /opt/homebrew/bin/brew を使用)。
  5. uv: curl -LsSf https://astral.sh/uv/install.sh | sh、その後 uv が見つからない場合は ~/.local/bin/uv を使用。
  6. python-tools: uv sync
  7. renderer: uv run playwright install chromium
  8. speech-model: バックグラウンドで uv run tools/get_models.py を実行(2.3 GB)。接続が切れても自動で再開します。ダウンロード中にインタビューに進みます。ステップ3で必要になる前に、ダウンロードの状態を確認します。

インストール中は、各ツールが何のためにあるのかを1行で説明します(doctorの説明文はそのために書かれています)。

2. ブランドインタビュー (3つの質問、一度に1つずつ)

会話形式で質問し、メッセージごとに1つの質問をします。ユーザーの正確な言葉をそのまま保存します。

名前、タグライン、「何をしているか」のラベルは尋ねないでください。ラボはデフォルトでは追加しません(新しいリールスキル「label」を参照)。

  1. エネルギー.「カメラに映るとき、あなたはどんな感じですか:落ち着いていて思慮深い、温かくておしゃべり、それともハイテンション?」これにより、編集の忙しさが決まります(ステップ4の表を参照)。
  2. ブランド.「ブランドやデザインファイル、ブランドカラー、フォントはありますか?デザインファイル(.mdまたはPDF)をドロップすると、そこからあなたのルックを作成します。または、カラーコードを貼り付けたり、お気に入りのリールのスクリーンショットを3~6枚 inspiration フォルダにドロップしてください。または「いいえ、オプションを見せて」とだけ言ってください。」
  3. 絶対に使わないもの.「リールに絶対に使いたくないものはありますか?例えば、すべて大文字のテキスト、特定の絵文字、効果音、絶対に言わない言葉など。」

回答を brand/profile.md に保存します:

# プロフィール
- エネルギー: 温かくておしゃべり
- ブランド: カラー #… / フォント … / inspiration/ 内のスクリーンショット / なし
- 絶対に使わないもの: …

また、各「絶対に使わないもの」を brand/preferences.md に1行ルールとして追加します。

3. 自分の顔でルックを確認する

尋ねます:「では、あなたがカメラに向かって話しているクリップを1つドロップしてください。できれば20秒以上。このチャットまたは inbox フォルダにドラッグしてください。完璧なテイクでなくても大丈夫です。ルックを試すためのものです。」

クリップが配置され(音声モデルが完了したら):

  1. uv run tools/transcribe.py "<クリップ>" --name welcome-sample

  2. projects/welcome-sample/lines.md を読みます。最初の3~5行のクリーンなライン、約12~20秒 で cut.json を作成し、新しいリールのラフカットルール(最後のクリーンテイク、言い間違いなし)を使用します。uv run tools/roughcut.py projects/welcome-sample --no-open と uv run tools/verify.py projects/welcome-sample を実行し、フラグが立ったものを修正します。このカットのレビューはユーザーに依頼しないでください。これはサンプルにすぎません。

  3. build.json を新しいリールスキルと同様に記述します:ユーザーが実際に言ったことから hooks スキルを使ってフックを書き(これはラボの第一印象なので、良いものにしてください)、1~2のハイライトワード、1つのズーム、最も強いラインに1つのステートメントを追加します。visuals スキルを使って2~4のポップアップを追加し(例えば、言及されたリストのチップ、プロンプトについて話す場合のチャットウィンドウ)、ラボが実際に何をするかをユーザーに見せます。ビハインドモーメントは追加しないでください。

  4. ルックシート: uv run tools/build.py projects/welcome-sample --looks presets を実行します。すべてのルックでクリップが並べて表示された1つの画像が開き、LOOKS= の後に印刷された順序で表示されます。最初に自分で画像を確認し(Read it)、テキストが読めること、顔を覆っていないことを確認します。

  5. 印刷された順序で、各ルックを1行ずつ短く紹介し、各キットの description(packs/<名前>/kit.json)を使用します。上の行はフックとキャプション、下の行はポップアップを示します。 次に、ルックは出発点であり、最終的な選択ではないことを明確に伝えます:

    一番 雰囲気 が気に入ったものを選んでください。すべて後から変更できます:「これだけど、セージとクリームで」、「私のカラーを使って:…」、「もっと柔らかいフォントで」、「ピンクなし」。あなたのクリップでやり直して見せます。

    どれを動いているところを見たいか尋ねます。

  6. ユーザーが選んだ各ルックに対して:uv run tools/build.py projects/welcome-sample --kit <名前> --out sample-<名前> を実行します。QuickTimeで開きます。2つ選んだ場合は、両方を作成して順に開きます。

ユーザーがステップ2でブランドカラー、フォント、スクリーンショットを提供した場合は、「あなたのブランドからルックを作ることもできます」と提案します。ステップ5を参照。

4. キットを保存する

ユーザーが選択したら(例:「エディトリアルだけど、セージとクリームで」または「プレイフルだけど、もっと落ち着いて」):

  1. packs/<プリセット>/kit.json を packs/<ユーザーのファーストネーム-小文字>/kit.json にコピーします。コピー内で:

    • "name": ユーザーの名前
    • "preset": false
    • "based_on": "<プリセット>"
  2. ユーザーのエネルギーを適用します:

    エネルギーintensityzoom jump / punchsfx volume_dbstatements
    落ち着いていて思慮深いclean1.04 / 1.08−17最大1
    温かくておしゃべりsignature1.07 / 1.13−13最大1~2
    ハイテンションfull1.12 / 1.22−10最大2

    rules.intensity、zoom、sfx.volume_db、rules.statement の文言を一致するように変更します。

    サウンドセット(sfx.palette):

    • 落ち着いている: soft
    • 温かい: soft または playful
    • ハイテンション: punchy
    • テクノロジーやAI関連のトピック: clicky を検討

    すべてのサウンドは sfx/sound-menu.mp4 で聞くことができ、「プレイフルなサウンドを使って」と依頼することでセットを切り替えられることを一度伝えます。ユーザーが「効果音なし」と言った場合は、"sfx": {} を設定します。すべて大文字禁止と言った場合は、style.caption_case、style.hook_case、style.statement_case を "none" に設定します。

  3. ユーザーのカラーを適用します。インタビューからか、その場で依頼された場合(「代わりにこれらの色を使って」):

    • 16進数カラーコードまたはプレーンな色名から: 「sage」や「dusty pink」で問題ありません。センスの良い16進数を選び、ユーザーに伝えます。
    • colors の値を入れ替え、役割を維持します:明るい色はカードとキャプションに、暗い色はステートメントの背景とインクに、鮮やかな色はハイライトと visuals.rotate に使用します。
    • コントラストを確認: テキストが背景に対して読みやすいこと。
    • ルックシートを再レンダリング してキット用に(--looks <ユーザーのキット>)、フルサンプルの前にユーザーが確認できるようにします。
    • フォントも同様に機能します: 無料のGoogleフォントであれば何でも(fonts.py で存在を確認)。
  4. キットのフォルダ名を brand/kit.txt に書き込みます。

  5. ユーザーのキットでサンプルをもう一度作成します:uv run tools/build.py projects/welcome-sample --out sample-mine。QuickTimeで開きます。尋ねます:「これがあなたのルックです。何か変更したいことはありますか?」変更をキットに適用し(プリセットではなく)、満足するまで再作成します。「キャプションを小さく」「黄色を減らして」「傾きなし」のような小さな変更は、kit.json の1行編集です。

5. ブランドからルックを作成する(依頼された場合)

デザインファイルから(最良の方法)

ユーザーがブランドまたはデザインのドキュメント(.md、PDF、Google Docのエクスポートなど、BRAND-DESIGN.md のようなもの)を持っている場合:

  1. ファイルを入手します。 チャットにドラッグするか brand/ にドロップするよう依頼し、コピーを brand/design.md として保存します(またはPDFのまま)。ルックのソースオブトゥルースとして使用します。

  2. キットにマッピングします:

    デザインファイル内kit.json 内
    カラーパレット(16進数コードとその用途)colors、さらに roles:背景 → hook_card と label_bg;テキストカラー → ink と hook_text;「ステートメント」または暗いブロック → statement_bg;ハイライトカラー → highlight_blocks;アクセント → accent_pill、visuals.rotate
    「純黒や純白は使わない」などのルール最も暗いブランドカラーをインクとして使用
    見出しとディスプレイフォントfonts.display / poster、そのイタリック体を fonts.italic、サンセリフ体を label とキャプションに
    特徴的な動き(イタリックの混在、単語の後ろのハイライトブロック、傾き、ステッカー、すべて大文字)moves と style(hook_case、statement_case、radius)
    ムード(「落ち着いた」「遊び心のある」「高級感」)visuals.motion、visuals.density、sfx.palette
    写真や動画のスタイル(暖かみ、ムーディー、明るい、フィルムライク)grade:contrast、saturation、brightness、warmth(−0.05~0.05)、vignette(0~0.5)、legibility(テキスト背後に暗いグラデーション、0~0.5)。肌は自然に保つ:フィルムグレインなし、強いクラッシュなし。
    アイコン、グラフィック要素、ステッカー、ボタン(線の太さ、角丸または四角、塗りつぶしカラータイル)visuals.icon_stroke(細い1.5 → 太い2.5)、visuals.radius、visuals.card(solid / outline / glass)、visuals.accent(アイコンタイルの色)、visuals.rotate(チップとステッカーの色)
  3. 有料またはカスタムフォント: フォントファイルを探します。ユーザーが持っている場合は fonts/private/ にドロップし、キットは "file" を使用します。持っていない場合は、最も近い 無料のGoogleフォント を選びます:コントラスト、幅(縦長か横長か?)、イタリック体があるかどうかを一致させます。何を代用したか、その理由を伝えます。例:「あなたの有料セリフフォント → Instrument Serif:同じ縦長でコントラストの高い雰囲気、イタリック体あり。」

  4. 表示します: --looks <ユーザーのキット> をレンダリングし、sample-mine をビルドします。どの部分がファイルから直接来たか、どの部分を解釈したかを説明します。

  5. 同期を維持します: 後でユーザーがデザインファイルを更新した場合(「ブランドカラーを変更しました」)、brand/design.md を再読み込みし、同じ方法でキットを更新します。

スクリーンショットまたは貼り付けられたカラーから

ユーザーがプリセットではなく独自のルックを希望する場合:

  1. inspiration/ 内のスクリーンショット、ブランドガイド、または貼り付けられたコードを読みます。以下に注意します:
    • タイプ:セリフかサンセリフか、どの程度太いか、すべて大文字か、イタリック体が混在しているか
    • キャプションの処理:アウトライン、シャドウ、ボックス;フレーズ全体か単語ごとか
    • カードの形状と半径
    • 4~6色
    • どの程度情報量が多いか
  2. 最も近いプリセットから始め、異なる部分のみを変更します。フォントは 無料のGoogleフォント である必要があります:{"family": "<Googleフォント名>", "google": true, "weight": N} と記述します(イタリック体の場合は "italic": true を追加)。各フォントが uv run tools/fonts.py "<ファミリー>" --weight N でダウンロードできることを確認します。ユーザーが有料フォントを所有している場合は、ファイルを fonts/private/ にドロップし、{"family": "...", "file": "fonts/private/<ファイル>", "weight": N} を使用できます。
  3. 他のクリエイターの正確なフォントとカラーをコピーしないでください。雰囲気を取り入れ、トレードマークのルックはコピーしません。
  4. --looks <ユーザーのキット> をレンダリングして確認し、ステップ4と同様に sample-mine をビルドし、チャットで繰り返します。

6. 完了

約3行で、次のことを伝えます:

  • ルックは保存され、すべてのリールで自動的に使用されます

  • リールの編集方法:inbox/ またはチャットにクリップをドロップし、「このリールを編集して」と言います。あなたがカットし、ユーザーがチャットでラインをレビューし、ルックでビルドします。

  • ポップアップグラフィックはユーザーの言葉を説明します。「グラフィックを見せて」と指示すると、ルック内の全14種類のカタログが再生されます

  • オプションの追加機能:チャットに自分のリールを6つドロップすると「周回するリール」効果とプロフィールグリッド(tools/reels.py add)を適用できます。Instagramの本物の数字を一度提供すると(brand/instagram.json に保存)、フォローアニメーションに使用されます

  • 任意のラインでミームやGIFを依頼できます(「このラインにデヴィッド・ローズの「ew」ミームを入れて」)。検索には無料のGIPHYキーが必要で、初回は入手を支援します。ユーザー自身のGIFファイルはすぐに使用できます

  • カラーとフォントはいつでも変更可能です:「代わりにこれらの色を使って」と任意のリールで言うだけで機能します

  • いつでも何でも変更できます。「キャプション小さく」「このリールは音なし」「このリールにはLoudルックを試して」など

  • 完成したリールは 完成したリール フォルダに保存されます

  • コマンド:/new-reel で新しいクリップ(各リールごとにこのフォルダで新しいチャットを開始)、/update で新しいバージョンを取得、/report-problem で問題が発生した場合に報告

その後、「今提供したクリップを最初の実際のリールとして編集してみませんか?」と提案します。はいの場合、このチャットで新しいリールスキルを実行します。

キットスタイルスイッチ(微調整用)

kit.json → "style":

  • caption_outline: px; 0はシャドウのみを意味します
  • caption_case: "none" / "uppercase"
  • hook: "card" / "bare"(カードなし、アウトラインテキスト)
  • hook_size
  • hook_case
  • statement_case
  • label: "ticket" / "pill"
  • label_mark: 名前とトピックの間の記号
  • radius
  • shadow / shadow_soft: rgba色

"captions":

  • mode: "karaoke"(単語が光る)、"phrase"(フレーズ全体)、"word"(一度に1つの大きな単語)
  • size
  • max_words
  • position_y

"moves":

  • tilt_degrees
  • highlighter_blocks

Individual skills in this repo

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

elkl111/reels-editing-lab-beta

Write hooks for a reel that are curious but human, true to the reel and specific to it. Use in the new-reel flow (opening check after the rough cut; on-screen hook and cover title in the build), when the user asks to change the hook ("hook 2", "different hook", "punchier hook"), or before filming ("give me hooks for a reel about X", "how should I open this?").

elkl111/reels-editing-lab-beta

Edit a talking-head reel from a raw clip. Use whenever the user says "I have a new reel", "edit this reel", "new clip", drags a video into the chat or drops one in inbox/, or gives edits to a rough cut ("drop line 3", "end line 9 at…", "good, move on"). Covers transcription, the rough cut and the review, all in the chat.

elkl111/reels-editing-lab-beta

Bundle a problem report for the Lab's maker. Use when the user says something is broken, wrong or confusing and wants to report it ("report a problem", "this isn't working, tell Elena", "send feedback"), or when a tool keeps failing after you've tried to fix it.

elkl111/reels-editing-lab-beta

Update the Reels Editing Lab to the newest version. Use when the user says "update", "update the Lab", "is there a new version?", or was told a new version is out.

elkl111/reels-editing-lab-beta

The visual director. Plans the pop-up explainer graphics (chips, numbers, chat windows, checklists, diagrams…) that illustrate what the speaker says, beat by beat, in their kit's style. Use in the new-reel build step, when the user asks for more or fewer graphics ("more pop-ups", "illustrate this part", "a checklist here"), or asks what graphics exist ("what can you add?", "show me the options").

関連スキル