Communitygithub.com

xiaocong3/ecommerce-video-skills

カバー画像とタイトルのA/Bテスト:ショート動画向けに複数セットのカバー(クリアフレームまたは無地素材+異なるタイトルとレイアウト)とタイトル/コピー文を生成し、3:4 / 9:16のカバーファイルと比較画像を出力。A/Bテスト方法と記録表も提供します。

ecommerce-video-skills とは?

このスキルは、ECショート動画のサムネイル(カバー)とタイトルを複数バリエーション生成・A/Bテストするためのツールです。主にTikTok、Douyin、WeChat Video、Xiaohongshuなど、縦型動画プラットフォーム向けのクリック率向上を目的としています。ユーザーが最終編集中の動画ファイルまたは無地の背景画像を入力すると、自動的に最も鮮明なフレームを抽出するか、指定画像を使用して3:4または9:16のアスペクト比のカバーを生成します。同時に、痛み質問、結果提示、シーン描写、数字リスト、ギャップ、比較といった6つのタイプのタイトル(14文字以内)を提案し、後続のA/Bテストで使用できます。スクリプトは`scripts/cover_ab.py`で、4種類のレイアウト(黄色字・黒縁取り、白字・赤縁取り、黄色背景・黒字の横断幕、半透明黒背景・白字)を自動ローテーションで適用し、すべてのバリエーションをまとめた比較画像`ab_sheet.jpg`を出力します。また、タイトルストラテジーのテンプレートやA/Bテスト記録表、よくある失敗とその修正方法も含まれ、テストプロセスを体系的に進められるよう設計されています。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/xiaocong3/ecommerce-video-skills/tree/HEAD/skills/cover-title-ab

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

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

ドキュメント

カバーとタイトルのA/Bテスト · Covers & Titles A/B

一度に3–4バージョンのカバー+6–10個のタイトルを生成し、「一度に一変数だけ変更」の原則でテストします。スクリプト:scripts/cover_ab.py。

Part of ecommerce-video-skills · より洗練されたカバー背景画像が必要な場合は、姉妹リポジトリ ecommerce-image-skills の xiaohongshu-cover を使用して3:4カバーを生成してください。

入力 Inputs

  • 完成動画(または無地素材画像:build/stillXX.png、商品シーン画像)
  • フック/セールスポイント(hook-3s-script から取得可能)
  • プラットフォーム:抖音/視頻号/TikTok(9:16カバー+3:4プレビュー切り抜き) · 小红书(3:4)

手順 Steps

  1. タイトルを書く(テンプレート参照):各タイトル ≤ 14文字、異なるフックタイプを網羅。

  2. カバーを生成する:

    # 推奨:字幕のない無地背景画像を使用
    python scripts/cover_ab.py out/video.mp4 --images build/still00.png build/still03.png build/still04.png \
        --titles "氷水は昼までもたない?|朝の氷、夜まで残る|通勤バッグで漏れない" --ratio 3:4 --outdir out/covers
    # または完成動画から最も鮮明なフレームを自動選択(完成動画フレームには字幕が含まれる可能性あり)
    python scripts/cover_ab.py out/video.mp4 --titles "タイトルA|タイトルB" --ratio 9:16
    

    出力:cover_A.jpg、cover_B.jpg … および比較画像 ab_sheet.jpg;4種類のレイアウトをローテーション(黄色字・黒縁取り / 白字・赤縁取り / 黄色背景・黒字横断幕 / 半透明黒背景・白字)。

  3. テストを設計する:一度に一変数のみ変更(タイトル or 背景画像 or レイアウト);同じ時間帯、同程度のトラフィックで公開;またはプラットフォームのカバー/タイトルテスト機能を利用(ある場合)。

  4. 記録する(下表)。クリック率や完視率など、プラットフォームのデータに基づき、感覚で選ばない。

タイトルの公式 Title formulas

タイプ例
痛み質問氷水は昼までもたない?
結果朝の氷、夜まで残る
シーン通勤バッグで漏れないカップ
数字リスト保温カップ選びはこの3点
ギャップ普通に見えるけど実はすごい
比較普通カップ vs これ、8時間放置(実際にテスト済み)

プロンプトテンプレート Prompt template

この販売動画用に8個のカバータイトル(≤14文字)と4個の投稿コピー(≤60文字、2–3個のハッシュタグ付き)を生成してください。
商品:{…};実際のセールスポイント:{…};プラットフォーム:{…}
各タイトルは異なるタイプ(痛み質問/結果/シーン/数字/ギャップ/比較)を使用し、絶対表現や証明できないデータは禁止。
出力:表(番号/タイプ/タイトル/推奨背景画像/推奨レイアウト)+ 推奨初回A/Bの組み合わせとその理由。

A/B記録表

バージョンタイトル背景画像レイアウト投稿時間インプレッションクリック率完視率結論
A氷水は昼までもたない?still00黄色字・黒縁取り
B朝の氷、夜まで残るstill03白字・赤縁取り

チェックリスト Checklist

  • タイトル ≤ 14文字、スマホサムネイルで判読可能
  • カバーの主体が鮮明で、商品が認識可能;文字が商品にかからない
  • 3:4に切り抜いた後もタイトルが完全に表示される(視頻号/抖音の情報流プレビュー)
  • 一度に一変数のみ変更;データ記録が完全
  • 絶対表現なし、虚偽データなし

よくある問題と修正 Failure fixes

問題修正
カバーに文字が二重に重なる--images で無地背景画像を指定し、完成動画フレームを使用しない
タイトルが改行されて見苦しい10文字以内に短縮するか、適切な位置で手動改行
自動フレーム選択がぼやける--frame-time を指定するか、--images で画像を指定
テスト結果が安定しないサンプルサイズが小さすぎる;テスト期間を延長するか、差が明らかなバージョンのみ比較する

Individual skills in this repo

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

関連スキル