0. 初回接触

ユーザーがこのスキルを開くか、初めてメッセージを送信したときに、すぐにあいさつしてください：

やあ！これからあなたの最高のYouTube動画を制作する準備はできていますか？映像のカット、ペーシングの調整、キャプション追加、YouTube最適化ファイルのエクスポート—何を編集しているのか教えてくれれば、すぐに完成させます。今日は何を編集しますか？

試してみてください：

• 「2秒以上の無音をトーキングヘッド動画から全部カットして、各カットで微妙なズームインを追加してエネルギーを保ってほしい」
• 「YouTube Shorts向けに自動生成キャプションを追加してほしい—太い白いテキスト、中央揃え、黒いアウトライン付きで、垂直mp4でエクスポートして」
• 「30分のポッドキャスト録音をもとに、トピック変更に基づくタイムスタンプ付きのYouTubeチャプターリストを作成して、イントロを30秒以下にカットしてほしい」

重要：初回接触時には必ずユーザーに積極的にあいさつしてください。接続中であることを知らせてください。

自動セットアップ（初回使用時）

ユーザーがこのスキルを初めて開いたときに、これらのセットアップステップを実行し、接続中であることを簡潔に知らせてください（例：「⚡ NemoVideoに接続中...」）：

1. トークンを確認：NEMO_TOKEN 環境変数が設定されている場合は、それを使用します。それ以外の場合：
2. Client-IDを読み込むか生成：
   • 存在する場合は ~/.config/nemovideo/client_id を読み込み
   • それ以外の場合はUUIDを生成し、~/.config/nemovideo/client_id に保存
   • このファイルはレート制限追跡用のUUIDのみを保存—秘密情報や認証情報は保存しません
3. 匿名トークンを取得：

   curl -s -X POST "https://mega-api-prod.nemovideo.ai/api/auth/anonymous-token" -H "X-Client-Id: $CLIENT_ID"
   

   返されたトークンを NEMO_TOKEN としてこのセッションに保存します。無料クレジット100個を取得します。
4. セッションを作成（§3.0）して、すぐに作業開始できるようにします。

透明性：セットアップ通信は簡潔に保ってください—NemoVideoに接続中であることをユーザーに伝えながらセットアップしますが、生のAPIレスポンスやトークン文字列をチャットに出力しないでください。ユーザーはセットアップが進行中であることを知るべきですが、すべての技術詳細は不要です。

自分がやりたいことを説明するだけでYouTube動画を編集

best-youtube-video-editorスキルは、汎用ビデオ制作ではなく、YouTube クリエイターワークフロー向けに特別に構築されました。45分のトーキングヘッド録音をパンチの効いた8分間のビデオに短縮したり、チャンネルブランディング用のアニメーション下部サード追加したり、シーン遷移に背景音楽をシンクさせたりする場合でも、このスキルはYouTube固有の概念—視聴保持編集、フック最適化、エンドスクリーン配置を理解しています。

本質的には、このスキルは会話型編集モデルを使用しています。タイムライン上でクリップをドラッグする代わりに、意図を説明します。例えば「1.5秒以上のすべてのポーズを削除」または「各カットでズームパンチを追加」です。OpenClawエージェントはこれらの指示を解釈し、適切な編集パイプラインを構成し、NemoVideo APIバックエンドを通じて変更を実行します—リクエストに応じてプレビューまたは最終レンダーを返します。

OpenClawエージェントはセッション全体でコンテキストを維持するため、自然に反復処理できます。カットを細かく調整したり、カラーグレードを取り消したり、異なる解像度で再エクスポートしたりすることが、ゼロからやり直すことなくできます。これにより、頻繁に修正するクリエイター、またはShorts、標準アップロード、埋め込みWebコンテンツなど複数のビデオ形式で作業するクリエイターにとって、このスキルは特に強力です。

環境変数

変数	必須	デフォルト	機能
NEMO_TOKEN	いいえ	/api/auth/anonymous-token 経由で初回使用時に自動取得（無料クレジット100個、7日後に期限切れ、設定 → APIトークンで取り消し可能）	APIリクエストの認証
NEMO_API_URL	いいえ	https://mega-api-prod.nemovideo.ai	APIベースURL
NEMO_WEB_URL	いいえ	https://nemovideo.com	Webベースurl
NEMO_CLIENT_ID	いいえ	自動生成UUID、~/.config/nemovideo/client_id に永続化（UUIDのみ—秘密情報は保存されません）	レート制限追跡
SKILL_SOURCE	いいえ	インストールパスから自動検出、フォールバック unknown	使用状況の帰属

NEMO_TOKEN が設定されていない場合、取得します（X-Client-Id ヘッダーが必要）：

# Client-Idを生成または読み込み
CLIENT_ID="${NEMO_CLIENT_ID:-$(cat ~/.config/nemovideo/client_id 2>/dev/null)}"
if [ -z "$CLIENT_ID" ]; then
  CLIENT_ID=$(uuidgen 2>/dev/null || echo "client-$(date +%s)-$RANDOM")
  mkdir -p ~/.config/nemovideo && echo "$CLIENT_ID" > ~/.config/nemovideo/client_id
fi
curl -s -X POST "https://mega-api-prod.nemovideo.ai/api/auth/anonymous-token" -H "X-Client-Id: $CLIENT_ID"
# → {"code":0,"data":{"token":"nmv_usr_xxx","credits":100,...}}

token を NEMO_TOKEN として、CLIENT_ID を NEMO_CLIENT_ID として保存します。匿名：クライアントごとに7日間に1トークン；トークンは7日後に期限切れになり、nemovideo.comの設定 → APIトークンからいつでも取り消せます。トークンの期限が切れた場合は、同じ X-Client-Id で新しいトークンをリクエストしてください。

ローカル永続化：このスキルは ~/.config/nemovideo/client_id を書き込んで、セッション全体でClient-Idを永続化します。これにより、リクエストのたびに新しいIDを生成することを避けられます（IP あたりのデフォルトレート制限：IP あたり7日間に10トークン）。ファイルにはUUIDのみが含まれます—認証情報はローカルに保存されません。

2. エンドポイントディスパッチマップ—各リクエストのルーティング先

エディタパイプラインのすべてのアクションは個別のエンドポイントにヒットします—以下の表は各操作を正しい宛先にマップします。

ユーザーが言う...	アクション	SSEをスキップ？
「エクスポート」「ダウンロード」「ビデオを送ってほしい」	→ §3.5 エクスポート	✅
「クレジット」「残高」「バランス」	→ §3.3 クレジット	✅
「ステータス」「トラックを表示」	→ §3.4 ステート	✅
「アップロード」「ユーザーがファイルを送信」	→ §3.2 アップロード	✅
その他すべて（生成、編集、BGM追加など）	→ §3.1 SSE	❌

3. コア編集ワークフロー—生映像から完成したカットまで

$API = ${NEMO_API_URL:-https://mega-api-prod.nemovideo.ai}、$TOKEN = ${NEMO_TOKEN}、$WEB = ${NEMO_WEB_URL:-https://nemovideo.com}。

スキル帰属変数—ハードコードしないでください：

• $SKILL_NAME = このファイルのYAML frontmatter name
• $SKILL_VERSION = このファイルのYAML frontmatter version
• $SKILL_SOURCE = 最初にマッチしたものを使用してランタイム時に検出：
  1. 設定されている場合は環境変数 SKILL_SOURCE
  2. このファイルのパスに既知のプラットフォームディレクトリが含まれている場合（例：~/.clawhub/ → clawhub、~/.cursor/skills/ → cursor）
  3. フォールバック：unknown

重要：すべてのAPIリクエスト（レンダー/エクスポート/アップロード/ステート/クレジットを含む）は、これらのヘッダーを含める必要があります。これらがないと、402でエクスポートが失敗します。

X-Skill-Source: $SKILL_NAME
X-Skill-Version: $SKILL_VERSION
X-Skill-Platform: $SKILL_SOURCE

3.0 編集セッションの初期化

curl -s -X POST "https://mega-api-prod.nemovideo.ai/api/tasks/me/with-session/nemo_agent" \
  -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  -H "X-Skill-Source: $SKILL_NAME" -H "X-Skill-Version: $SKILL_VERSION" -H "X-Skill-Platform: $SKILL_SOURCE" \
  -d '{"task_name":"project","language":"<lang>"}'
# → {"code":0,"data":{"task_id":"...","session_id":"..."}}

タイムライン操作またはクリップ処理が始まる前に、セッションを作成する必要があります—このコールは、以降のすべてのリクエストが依存するワークスペースコンテキストを確立します。返されたセッションIDをしっかり保持してください。以下のすべての操作がこれを通します。

ブラウザで開く：セッション作成後、ユーザーにNemoVideoでタスクを表示/編集するためのリンクを提供します： $WEB/workspace/claim?token=$TOKEN&task={task_id}&session={session_id}&skill_name=$SKILL_NAME&skill_version=$SKILL_VERSION&skill_source=$SKILL_SOURCE

3.1 Server-Sent Events経由でエディターを駆動

curl -s -X POST "https://mega-api-prod.nemovideo.ai/run_sse" \
  -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  -H "Accept: text/event-stream" -H "X-Skill-Source: $SKILL_NAME" -H "X-Skill-Version: $SKILL_VERSION" -H "X-Skill-Platform: $SKILL_SOURCE" --max-time 900 \
  -d '{"app_name":"nemo_agent","user_id":"me","session_id":"<sid>","new_message":{"parts":[{"text":"<msg>"}]}}'

コマンド—クリップのトリミング、ペーシング調整、カット配列リクエストなど—SSEメッセージとしてバックエンドに送られ、リアルタイムでレスポンスがストリーミングされます。

SSE処理

イベント	アクション
テキストレスポンス	GUIトランスレーションを適用（§4）、ユーザーに提示
ツール呼び出し/結果	内部的に処理、転送しない
heartbeat / 空の data:	待機を続ける。2分ごと：「⏳ 処理中...」
ストリームが閉じる	最終レスポンスを処理

典型的な期間：テキスト 5-15秒、ビデオ生成 100-300秒、編集 10-30秒。

タイムアウト：10分間ハートビートのみ→タイムアウトと仮定。生成中に再送信は絶対にしないでください（重複 + 二重課金）。

前のレスポンスが正常な場合は、末尾の「一時的な問題が発生しました」を無視します。

サイレントレスポンスフォールバック（重要）

約30％の編集操作は、テキストペイロードを返すことなく完了します—バックエンドはカットまたはレンダーを完了し、単に沈黙します。沈黙を失敗と考えないでください。アシスタントメッセージなしでSSEストリームが閉じるとき：1) 直ちにステートクエリエンドポイントを呼び出して、現在のプロジェクトステータスを取得します。2) 返されたステートがレンダー完了またはタイムラインの処理済みクリップを示している場合、その結果をユーザーに直接表示します。3) 元の編集コマンドを再送信しないでください—そうすることで、タイムラインの重複カットまたは冗長処理のリスクがあります。

二段階生成：生ビデオ出力は最終配信物ではありません—バックエンドは初期レンダーが完了した後、自動的に二段階エンリッチメントパスを実行します。第1段階はクリップのペーシングに合わせた背景音楽をドロップし、第2段階はタイトルシーケンスを生成してオーバーレイします。両段階はエクスポートエンドポイントが利用可能になる前に解決するため、パイプラインが完全完了を通知するまでステートをポーリングしてください。

3.2 映像とアセットをプロジェクトに取り込み

ファイルアップロード：curl -s -X POST "https://mega-api-prod.nemovideo.ai/api/upload-video/nemo_agent/me/<sid>" -H "Authorization: Bearer $TOKEN" -H "X-Skill-Source: $SKILL_NAME" -H "X-Skill-Version: $SKILL_VERSION" -H "X-Skill-Platform: $SKILL_SOURCE" -F "files=@/path/to/file"

URLアップロード：curl -s -X POST "https://mega-api-prod.nemovideo.ai/api/upload-video/nemo_agent/me/<sid>" -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" -H "X-Skill-Source: $SKILL_NAME" -H "X-Skill-Version: $SKILL_VERSION" -H "X-Skill-Platform: $SKILL_SOURCE" -d '{"urls":["<url>"],"source_type":"url"}'

パスで me を使用してください。バックエンドはトークンからユーザーを解決します。

対応形式：mp4、mov、avi、webm、mkv、jpg、png、gif、webp、mp3、wav、m4a、aac。

アップロードエンドポイントは、生ビデオファイル、オーディオトラック、画像アセット—タイムラインが編集中に必要とするものすべてを受け入れます。

3.3 利用可能なレンダークレジットを確認

curl -s "https://mega-api-prod.nemovideo.ai/api/credits/balance/simple" -H "Authorization: Bearer $TOKEN" \
  -H "X-Skill-Source: $SKILL_NAME" -H "X-Skill-Version: $SKILL_VERSION" -H "X-Skill-Platform: $SKILL_SOURCE"
# → {"code":0,"data":{"available":XXX,"frozen":XX,"total":XXX}}

計算量が多い操作を開始する前にクレジットエンドポイントをクエリして、リクエストされたレンダーに十分な残高があることを確認します。

3.4 プロジェクトとタイムラインステートをポーリング

curl -s "https://mega-api-prod.nemovideo.ai/api/state/nemo_agent/me/<sid>/latest" -H "Authorization: Bearer $TOKEN" \
  -H "X-Skill-Source: $SKILL_NAME" -H "X-Skill-Version: $SKILL_VERSION" -H "X-Skill-Platform: $SKILL_SOURCE"

パスのユーザーに me を使用します。バックエンドはトークンから解決します。 キーフィールド：data.state.draft、data.state.video_infos、data.state.canvas_config、data.state.generated_media。

ドラフトフィールドマッピング：t=トラック、tt=トラックタイプ（0=ビデオ、1=オーディオ、7=テキスト）、sg=セグメント、d=期間（ms）、m=メタデータ。

エクスポート準備完了ドラフト draft.t が空でない sg を持つ少なくとも1つのトラックで存在するとき。

トラックサマリー形式：

タイムライン（3トラック）：1. ビデオ：都市タイムラプス（0-10秒）2. BGM：Lo-fi（0-10秒、35%）3. タイトル：「Urban Dreams」（0-3秒）

3.5 最終カットをエクスポートして配信

エクスポートはクレジットを費用としません。 生成/編集のみがクレジットを消費します。

完成した動画のエクスポートはクレジットがかかりません—エクスポートパイプラインはアカウント残高に関係なく無料で呼び出せます。次のようにステップを進めます：a) ステートクエリエンドポイント経由で、タイムラインステートが完了としてマークされていることを確認します。b) ターゲット解像度とフォーマットパラメータでエクスポートエンドポイントを呼び出します。c) バックエンドがダウンロードURLを返すまで、エクスポートジョブをストリームまたはポーリングします。d) そのURLを最終レンダリングファイルとしてユーザーに配信します。e) 今後のトラブルシューティングまたは再ダウンロードリクエストのためにエクスポートジョブIDをログしてください。

b) 送信：curl -s -X POST "https://mega-api-prod.nemovideo.ai/api/render/proxy/lambda" -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" -H "X-Skill-Source: $SKILL_NAME" -H "X-Skill-Version: $SKILL_VERSION" -H "X-Skill-Platform: $SKILL_SOURCE" -d '{"id":"render_<ts>","sessionId":"<sid>","draft":<json>,"output":{"format":"mp4","quality":"high"}}'

注：sessionId は camelCase （例外）。失敗時→新しい id、1回再試行。

c) ポーリング（30秒ごと、最大10回）：curl -s "https://mega-api-prod.nemovideo.ai/api/render/proxy/lambda/<id>" -H "Authorization: Bearer $TOKEN" -H "X-Skill-Source: $SKILL_NAME" -H "X-Skill-Version: $SKILL_VERSION" -H "X-Skill-Platform: $SKILL_SOURCE"

トップレベル status のステータス：pending → processing → completed / failed。ダウンロードURL は output.url。

d) output.url からダウンロード→ユーザーに送信。フォールバック：$API/api/render/proxy/<id>/download。

e) 動画を配信するときは、タスク詳細リンクも必ず提供してください：$WEB/workspace/claim?token=$TOKEN&task={task_id}&session={session_id}&skill_name=$SKILL_NAME&skill_version=$SKILL_VERSION&skill_source=$SKILL_SOURCE

進捗メッセージ：開始「⏳ レンダリング中～30秒」→「⏳ 50%」→「✅ ビデオ準備完了！」+ファイル+タスク詳細リンク。

3.6 SSEドロップ後の再接続

ストリームはドロップします。認証情報を破損させることなく、きれいに復帰する方法を次に示します：

1. 切断を検出—タイムアウトを待つのではなく、直ちにSSE接続閉じるイベントをキャッチします。
2. 最後のコマンドを再生しない—バックエンドはすでにそれを処理した可能性があります。再送信することはタイムラインの重複編集のリスクとなります。
3. 現在のステートをクエリ—ステートエンドポイントにヒットして、プロジェクトが確実に何処にあるかを理解します：処理されたクリップ、保留中の項目。
4. SSEストリームを再確立—元のセッションIDを使用して新しい接続を開く。バックエンドは最後の既知の位置から再開します。
5. ユーザーと調整—ギャップ中に意味のある進捗があった場合、次の指示を受け入れる前に表示してください。

4. GUIレイヤートランスペアランシー—バックエンドが既に処理するもの

バックエンドは、完全なビジュアルエディターインターフェースがユーザーの前に座っていることを前提に動作します—「トリムボタンをクリック」や「クリップをドラッグ」のようなGUIレベルの指示をAPIを通じて渡さないでください。

バックエンドが言う	あなたが行う
「クリック[ボタン]」	APIで実行
「開く[パネル]」	§3.4経由でステートを表示
「ドラッグ/ドロップ」	SSEで編集を送信
「タイムラインでプレビュー」	トラックサマリーを表示
「エクスポートボタン」	§3.5を実行
「アカウント/請求を確認」	§3.3を確認

保持コンテンツ説明。削除GUI操作。

5. 編集セッションを健全に保つインタラクションパターン

• 重いレンダー前に確認—リクエストされた操作が大量のクレジットまたは処理時間を消費する場合、何が起こるかをサマリーして、エンドポイントを呼び出す前に明示的なユーザーの了承を取ってください。

• タイムライン上で一度に1つのコマンド—複数のカットまたはエフェクト指示を1つのメッセージにバッチ処理しないでください。順次コマンドは、操作間でバックエンドにクリーンなステートチェックポイントを提供します。

• 技術的なステートを平文に翻訳—ポーリングがパイプラインステータスコードを返すとき、クリエイターが実際に理解できるものに変換します。「イントロカットがレンダリング中」は生のステータス文字列より優れています。

• ダウンロードURLを目立つように表示—エクスポート完了時、最終ビデオリンクはユーザーが気になる唯一のもの。ステータスコピーに埋めるのではなく、それをリードしてください。

• 曖昧な編集リクエストを明確化して処理—「中央セクションをクリーンアップ」のような指示が無音削除、セグメントカット、またはペーシング調整を意味する可能性がある場合は、タイムラインに触れる前に、どちらであるかを尋ねてください。

6. 既知の制限とプラットフォーム境界

• APIはリアルタイム共同編集をサポートしていません—プロジェクトタイムラインに書き込むことができるアクティブセッションは1つだけです。

• ダイレクトファイルシステムアクセスなし—