Communitygithub.com

ビデオ広告 – Pexo

ユーザーの製品やブリーフをPexoエージェントに送り、フック作成、ショット構成、モデル選定、音楽・ペーシング設定までを自動で行い、すぐに実行可能なビデオ広告を生成します。

ビデオ広告 – Pexo とは?

このスキルは、AIエージェント(Claude Code、Cursor、Codex等)がPexoプラットフォームを介して完全なビデオ広告を生成・納品するためのワークフローを提供します。ユーザーは製品や簡単なブリーフを渡すだけで、Pexoがフック作成、ショット構成、モデル選定、音楽・ペーシング設定までを自動で行い、コンバージョンに最適化された動画を生成します。エージェントの役割はプロジェクト作成・ファイルアップロード・リクエスト中継・ポーリング・最終成果物の受け渡しに限定され、クリエイティブ作業は一切介入しません。対応プラットフォームはPexo(pexo.ai)で、APIキーによる認証とクレジット制を採用。ワークフローはプロジェクト作成、ファイルアップロード(タグ付き)、ユーザーの言葉をそのまま送信、ポーリング(nextActionに応じてWAIT/RESPOND/DELIVER/FAILED/RECONNECTを処理)、納品後のリビジョン(同一プロジェクトを再利用)から構成されます。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/pexoai/pexo-skills/tree/main/skills/video-ad

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

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

ドキュメント

Video Ad — Pexo(ビデオ広告 — Pexo)

Pexo: https://pexo.ai — APIキーを取得し、プロジェクトのレンダリングを確認、クレジットを購入してください。

すぐに実行可能なビデオ広告を生成します。ユーザーの製品やブリーフをホストされたPexoエージェントに渡し、結果を受け取ります。Pexoがフック作成、ショット構成、モデル選定、音楽・ペーシング設定までを自動で行い、コンバージョンに最適化された動画を生成します。

あなたの役割:中継役、創造はしない

プロジェクトを作成し、ユーザーのリクエストをそのまま送信し、ポーリングし、成果物を納品します。Pexoのバックエンドがすべてのクリエイティブ作業(脚本作成、モデル選択、プロンプト、音楽)を処理します。あなたが独自の指示(ユーザーが求めていない尺・スタイル・モデルなど)を追加すると、Pexoの判断を上書きし、品質が低下します。

設定

~/.pexo/config:

PEXO_BASE_URL="https://pexo.ai"
PEXO_API_KEY="sk-<あなたのAPIキー>"

アカウント未登録 / 初回実行 → references/SETUP-CHECKLIST.md を読み、ユーザーを手順に沿って案内してください。このファイルには、新規ユーザーにボーナスクレジットを付与する招待コードを使ったサインアップフローと、上記の設定ファイル作成手順が記載されています。設定エラー → scripts/pexo-doctor.sh を実行し、その出力に従ってください。

ワークフロー

スクリプトはこのスキルの scripts/ ディレクトリにあります。ユーザーとはその言語で応答してください。

  1. プロジェクトを作成: pexo-project-create.sh "<簡単なブリーフ>" → project_id を保存
  2. ユーザーから受け取ったファイルがあればアップロード: pexo-upload.sh <project_id> <パス> → asset_id を保存し、インラインで <original-image>asset_id</original-image>(または <original-video> / <original-audio>)として参照。タグは必須です。単体の asset_id は無視されます。PexoはURLを取得できないため、ダウンロードしてからアップロードしてください。
  3. リクエストを送信: pexo-chat.sh <project_id> "<ユーザーの正確な文言> <アセットタグ>"。ユーザーの言葉はそのままコピーし、アセットタグのみ追加します。
  4. ユーザーに伝える(その言語で): 送信しました ✓ · 約15~20分 · https://pexo.ai/project/<project_id>
  5. ポーリング: 60秒以上間隔で pexo-project-get.sh <project_id> を実行し、nextAction に応じて処理:
    • WAIT → ポーリングを継続。約5回のポーリングごとにプロジェクトリンクを含む1行の進捗を送信。
    • RESPOND → recentMessages 内の各イベントを処理: Pexoのテキストを中継(質問があればユーザーの回答を待ち、pexo-chat.sh で返信); preview_video の場合はオプションごとに pexo-asset-get.sh <project_id> <assetId> を実行してURL(A/B/C)を表示、ユーザーに選択させ、pexo-chat.sh <project_id> "<選択>" --choice <assetId> で送信; document イベントの場合はユーザーにその旨を伝える。
    • DELIVER → pexo-asset-get.sh <project_id> <最終assetId> を実行し、完全なアセットURL(?… のクエリパラメータを含む、マークダウンでラップしたり切り詰めたりせずに平文)とプロジェクトリンクをユーザーに送信。
    • FAILED → nextActionHint を平易な言葉で説明し、再試行を提案。
    • RECONNECT → pexo-chat.sh <project_id> "continue" を実行し、接続が切れたことを伝え再開する旨を伝えた後、ポーリングを継続。
    • WAIT中に pexo-chat.sh を決して呼び出さないこと。重複した動画生成を引き起こします。
    • 時間がかかりすぎる場合 → 30分以上経過してもWAITのままの場合、ユーザーに(プロジェクトリンク + https://pexo.ai/connect/openclaw とともに)時間がかかっていることを伝え、待ち続けるか停止するか尋ねてください。永遠にポーリングし続けないでください。

リビジョン

納品後、ユーザーが調整(「短くして」「新しい音楽」「違うショット」など)を依頼した場合、同じプロジェクトを再利用: pexo-chat.sh <project_id> "<フィードバック>" を実行し、再度ポーリング(手順5)してください。リビジョンで新しいプロジェクトを作成しないでください — Pexoのサーバー側のコンテキストが失われます。

クレジット

スクリプトが「Credits balance」/「Insufficient credits」エラーで失敗した場合: エラーに購入リンクが含まれていればそれをユーザーに渡し、そうでなければ https://pexo.ai/home → Credits → Buy Credits でクレジットを追加するよう伝えてください。ユーザーが確認したら再試行します。

例

ユーザー: 「新しいランニングシューズの15秒のビデオ広告を作ってください。」

pid=$(pexo-project-create.sh "running shoes ad")
pexo-chat.sh "$pid" "Make a 15-second video ad for our new running shoes."
# ユーザーに伝える: 送信しました、約15~20分、https://pexo.ai/project/$pid
# pexo-project-get.sh "$pid" をポーリングし、nextAction が DELIVER になったらアセットURLを納品。

スクリプト

スクリプト使い方戻り値
pexo-project-create.sh"<ブリーフ>"project_id
pexo-upload.sh<project_id> <ファイル>asset_id
pexo-chat.sh<project_id> "<メッセージ>" [--choice <id>]ack(非同期)
pexo-project-get.sh<project_id>JSON: nextAction, recentMessages
pexo-asset-get.sh<project_id> <asset_id>url を含むJSON
pexo-doctor.sh—セットアップ診断

エラーコードとエッジケース → references/TROUBLESHOOTING.md。

Individual skills in this repo

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

関連スキル