Communitygithub.com

alecs5am/ralphy

製品のリアルなAI UGC広告を生成するためのエンドツーエンドのワークフロー。15秒フォーマット。本物に見え、AI感がありません。

ralphy とは?

このスキルは、AIを活用して本物そっくりのUGC(ユーザー生成コンテンツ)形式の動画広告を生成するための完全なパイプラインを提供します。ターゲットは、SNS広告において「AI感」を排除し、実際のクリエイターが制作したかのような自然な見た目と雰囲気を求めるマーケターやブランドです。ワークフローは、スクリプト作成(Claude Sonnet 4.6)、クリエイターの顔生成(Nano Banana Pro)、動画生成(Kling 3.0)の3つの主要ステップで構成され、各ステップで最高のリアリズムを追求します。このスキルは、パターンインタラプトフックやビフォーアフターの変換といったバイラル性の原則を各工程に組み込み、視聴者の信頼とエンゲージメントを最大化することを目的としています。対応プラットフォームはHiggsfield、Fal.ai、Google AI Studio、Kling AI公式サイトなどで、コストは無料から有料まで段階があります。

対応✓Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/alecs5am/ralphy/tree/HEAD/notes/skills/ugc-ad-production

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

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

ドキュメント

UGC広告制作パイプライン

必要な入力(開始前にユーザーにこれらすべてを尋ねてください)

何かを生成する前に、以下を収集してください。

  • 製品 — 何を宣伝するか(名前、URL、または画像)
  • 参考UGC動画 — 同じジャンル/スタイルの実際のUGC動画(Pinterest、TikTok、YouTubeのリンク)。スクリプトのスタイル、クリエイターの個性、ショットの参考に使用します。
  • クリエイターの顔の参考画像 — 実在する人物の画像を2枚以上(魅力的で、ブランドの雰囲気に合っているもの)。これらをNano Banana Proでフェイスミックスし、新しい架空のクリエイターを作成します。
  • ターゲットオーディエンス — 広告の対象者(例:18〜35歳のニキビができやすい肌の女性)
  • フックのタイプ — 問題/解決、ビフォー/アフター、 testimonial、変身、または製品に基づいてエージェントに決定させる
  • 絶対に質問しないこと
  • どの編集ツールを使うか(常にCanva)
  • 動画の長さ(常に15秒)
  • アスペクト比(常に9:16縦長)
  • どの動画モデルを使うか(常にKling 3.0)
  • どの画像モデルを使うか(常にNano Banana Pro)

ステップ1 — スクリプト作成(Claude 4.6)

  • ツール: Claude claude-sonnet-4-6(強力な推論力+クリエイティブライティング — できるだけ多くのコンテキストを提供してください)

プロンプトテンプレート:

[参考動画]のようなUGCスクリプトを、[製品]用に作成してください。
UGCクリエイター/話者として、[顔の参考画像から得たクリエイターの説明]を使用してください。
以下を含めてください:
- フック(最初の3〜5秒):問題を視覚的に表示 + オーディオフック
- 正確な言葉を含むナレーション行
- カットの説明:各瞬間にカメラが映すもの(クリエイターの顔、製品、ビフォー/アフターなど)
- 動作と癖:クリエイターを実際のキャラクターのように感じさせる — 緊張した笑い、髪を触る仕草、直接のアイコンタクト、製品を指さすなど
- 行動喚起(最後の2〜3秒)
- 各カット/アクションのタイムスタンプ
タイムスタンプ | ナレーション | ビジュアル/ショット | アクション/マニエリスム の列を持つ撮影スクリプトとして出力してください。

注意事項:

  • Claudeに最大限のコンテキストを与えてください:参考動画のURL、製品詳細、ターゲットオーディエンスの課題、そのニッチでバイラルになった他のUGC動画、ストーリーテリングのフレームワーク(問題-動揺-解決、ビフォー/アフターなど)
  • コンテキストが多ければ多いほど、スクリプトの質が向上します。ここでのClaudeの強みは推論能力です。
  • 組み込むべきバイラル性の原則:パターンインタラプトフック、社会的証明、変身の瞬間、緊急性のあるCTA
  • 出力: ナレーション、ビジュアル、クリエイターの動作がタイムスタンプ付きで記載された撮影スクリプト。

ステップ2 — クリエイターの顔を生成する(Nano Banana Pro)

  • ツール: Nano Banana Pro(4K — リアルな肌の質感、毛穴、ディテールに必須)

プロンプトテンプレート:

これら2つの顔をミックスして、実在の人物には属さない新しい魅力的な顔を作成してください。
結果をUGCビューティ/ライフスタイルコンテンツクリエイターの顔として使用してください。
4K解像度で生成してください。超リアルな肌の質感、自然な照明、リングライトマイクを手に持ったクリエイター。

注意事項:

  • ブランドの個性に合ったPinterest/ストックの顔の参考画像を2枚以上使用する(親しみやすく、野心的で、ニッチに適したもの)
  • 最初のフレームの参考として、製品を手に持った、または顔の近くに置いた状態で生成する
  • 肌の毛穴、微細なディテール、自然な不完全さを出す — これによりAIに見えなくなります
  • プラットフォームの選択肢(安い順):
    • Higgsfield(クリエイタープラン) — フリーミアム、動作する
    • Fal.ai — クーポン pixelriot20hackathon-fal を使用すると20ドルの無料クレジット
    • Google AI Studio — 有料、最も制御可能
  • 3〜5バリエーションを生成し、最もリアルなものを選択する
  • 出力: AIクリエイターが製品を手に持った4Kポートレート画像。

ステップ3 — 動画を生成する(Kling 3.0)

  • ツール: Kling 3.0(15秒マルチショットモデル)

なぜKling 3.0なのか:

  • 15秒のネイティブ出力長
  • マルチショット:クリエイターのスピーチ → 製品のクローズアップ → 肌の変化 → クリエイターに戻る、のカットを切り替えられる
  • 表現力豊か:クリエイターの動作、ジェスチャー、個性を理解する
  • コンテンツプラットフォームの文脈的理解を持つ(UGCネイティブ)

設定:

  • 入力: クリエイター画像(ステップ2)を開始フレームとして
  • 入力: 製品画像を参照画像として(必ずしも開始フレームである必要はない — 途中の参照として使用可能)
  • 入力: 撮影スクリプト(ステップ1)を動き/ショットのプロンプトとして

プロンプト構造:

[最初のフレーム:クリエイターが製品を手に持ち、カメラを見て、自然な照明]
カット1(0〜3秒):クリエイターがカメラに直接話しかけ、[動作]をし、「[フックのセリフ]」と言う
カット2(3〜7秒):製品が肌に塗布/使用されているクローズアップ
カット3(7〜12秒):クリエイターのリアクションショット — [スクリプトから感情/動作]
カット4(12〜15秒):クリエイターがカメラに向かい、CTAを伝え、[動作]

注意事項:

  • 各カットに何が表示されるかをKlingに正確に指示する = ショットの制御。これは単なるプロンプティングではなく、ディレクションです。
  • マルチショット = プロンプターではなく、ディレクターのようにカットを記述します。
  • 混乱した場合:試行する前にKling 3.0のマルチショットチュートリアルを見てください。
  • コスト:15秒クリップあたり約4〜5ドル。無料テスト:Fal.aiでクーポン pixelriot20hackathon-fal を使用
  • プラットフォーム:Higgsfield、Kling AI公式サイト、Fal.ai
  • 出力: 15秒の生の動画クリップ。

バイラル性の原則(すべてのステップに組み込む)

  • フック = 問題の鏡:最初の3秒で視聴者自身の問題を見せる。彼らは自分自身を見てスクロールを止める。
  • ビフォー/アフター = 希望のループ:問題のフックの後、変化を見せる。これが欲求を生み出す。
  • オーディオフック:カット時の「ウーッ」という効果音はパターンインタラプト — 視聴時間を維持する。
  • クリエイターの動作 = 信頼:実際の人物のように感じられるクリエイター(緊張して笑う、髪を触る、ため息をつく)は、完璧な配信よりも無意識の信頼を素早く構築する。
  • リバーブ = 部屋の存在感:10%のリバーブで、声がスタジオではなく実際の空間で録音されたように感じられる。"AIラジオ声"感を取り除く。
  • CTAの緊急性:最後の2〜3秒。直接的で、具体的で、低摩擦(「リンクはプロフィールに」、「リンクをタップ」、「DMしてください」)。

ブランディングに関する注意

これが実際のアカウント/ブランド用の場合(テストではない場合):

  • クリエイターの顔はブランドのターゲットオーディエンスのペルソナに一致する必要がある
  • クリエイターのスタイル/雰囲気はすべてのUGC動画で一貫している必要がある

動画間で美学を混ぜないでください — 1つ選んで固定してください

プラットフォーム/コスト概要

ツール目的コスト
Gemini 2.5 Proスクリプト作成無料(AI Studio)
Nano Banana Proクリエイターの顔 + 製品画像Higgsfieldクリエイタープラン / Fal.ai(20ドルクーポン: pixelriot20hackathon-fal)
Kling 3.0動画生成約4〜5ドル/クリップ — Higgsfield / Kling AI / Fal.ai
ElevenLabs音声クローン + 交換有料(音声トレーニング機能)
Play.ht音声クローン(代替)フリーミアム
Canva動画編集 + テキスト無料 / Pro
Artlist効果音有料(無料の代替手段あり)

Individual skills in this repo

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

alecs5am/ralphy

>- Composition and render craft — assembles scenario.json plus asset-manifest.json into a HyperFrames HTML composition and renders the mp4. Owns timing, transitions, captions, audio mix and ducking, the green zone, the render pipeline, and VO sync. Generates no media of its own. USE WHEN the user asks to "compose the video", "render", "preview", "fix the captions", "mix the audio", "tighten the transitions", "final cut", or edits HyperFrames composition code. TRIGGER (EN): "render it", "compose the video", "captions", "audio mix", "transitions", "final cut", "preview the composition".

alecs5am/ralphy

HyperFrames CLI dev loop — `npx hyperframes` for scaffolding (init), validation (lint, inspect), preview, render, and environment troubleshooting (doctor, browser, info, upgrade). Use when running any of these commands or troubleshooting the HyperFrames build/render environment. For asset preprocessing commands (`tts`, `transcribe`, `remove-background`), invoke the `hyperframes-media` skill instead.

alecs5am/ralphy

Asset preprocessing for HyperFrames compositions — text-to-speech narration (Kokoro), audio/video transcription (Whisper), and background removal for transparent overlays (u2net). Use when generating voiceover from text, transcribing speech for captions, removing the background from a video or image to use as a transparent overlay, choosing a TTS voice or whisper model, or chaining these (TTS → transcribe → captions). Each command downloads its own model on first run.

alecs5am/ralphy

Install and wire registry blocks and components into HyperFrames compositions. Use when running hyperframes add, installing a block or component, wiring an installed item into index.html, or working with hyperframes.json. Covers the add command, install locations, block sub-composition wiring, component snippet merging, and registry discovery.

alecs5am/ralphy

Create video compositions, animations, title cards, overlays, captions, voiceovers, audio-reactive visuals, and scene transitions in HyperFrames HTML. Use when asked to build any HTML-based video content, add captions or subtitles synced to audio, generate text-to-speech narration, create audio-reactive animation (beat sync, glow, pulse driven by music), add animated text highlighting (marker sweeps, hand-drawn circles, burst lines, scribble, sketchout), or add transitions between scenes (crossfades, wipes, reveals, shader transitions). Covers composition authoring, timing, media, and the full video production workflow. For dev-loop CLI commands (init, lint, inspect, preview, render) see the hyperframes-cli skill; for asset preprocessing commands (tts, transcribe, remove-background) see the hyperframes-media skill.

alecs5am/ralphy

>- How to make a vivid, character-driven brand POSTER — a single still image, not a video. A generalized overlay on the art-director step: supplies the poster-as-landing architecture (top banner → massive beveled wordmark → chest-up hero photo → scattered vinyl-sticker collage → copy block → thin footer strip), the parameterized slot set (brand, exclamation word, hero, product, palette, original blob glyph, aesthetic register), the model stack (gpt-5.4-image-2 for crisp typography, gemini fallback), and the niche's failure modes. Works for ANY brand and ANY aesthetic the user names — Y2K streetwear, vaporwave, grunge zine, clean DTC — the skill supplies the layout know-how, the user supplies the subject + vibe. USE WHEN the user asks for a poster / flyer / drop poster / "poster-as-landing-page" / brand key-art / album-cover-style still / hype graphic, with no specific existing poster to reproduce. This is a content-niche craft-overlay SKILL (generalized), loaded on top of a poster-format template match — n...

alecs5am/ralphy

>- Compatibility shim for the legacy `/ralphy-remotion` skill name. Use when a saved Claude Code command, old project note, or user request still mentions Ralphy Remotion; redirect the task to HyperFrames and the current Ralphy render playbooks instead of authoring new Remotion code.

alecs5am/ralphy

>- Compatibility shim for the legacy `/remotion-to-hyperframes` skill name. Use when an old project, note, or user request asks to migrate Ralphy Remotion work; translate the intent into the current HyperFrames composition model and follow the editor and HyperFrames playbooks.

alecs5am/ralphy

The full extract → classify → blueprint → de-dup → publish pipeline for a finished `.ralphy/workspaces/<ws>/projects/<id>/`. Reads its `units/*/unit.json` (#069) as the Unit source of truth, then factors the project into ALL FIVE entities — Unit + the four typed blocks Template (structure), Style (look), Recipe (effect/treatment), Asset (reusable media). Applies the recipe-vs-tag split (#082/#083): a candidate is a Recipe only if it carries an extractable artifact (ffmpeg filtergraph / HyperFram

alecs5am/ralphy

>- How to make a realistic AI UGC ad for a product — generalized niche know-how that looks real and doesn't feel AI. A domain overlay on the standard pipeline: supplies the shooting-script shape (timestamp | VO | shot | mannerism), the creator-persona build, the problem-mirror hook, the trust-through-mannerisms rule, and the 9:16 ~15s UGC format defaults. Works for ANY product the user names — their skincare line, a no-name app, a gadget. The skill supplies the know-how; the user supplies the product. USE WHEN the user asks for a UGC ad / creator-style product ad / "make an ad that looks like a real person reviewing my product" / testimonial-style or problem-solution short for TikTok / Reels / Shorts, with no specific existing video to reproduce. This is a niche SKILL (generalized), not a remix TEMPLATE. For "remix this exact ad but swap the product/person", use the remix path (docs/skills-vs-templates.md). For swapping the creator in an existing clip, see /ugc-model-swap.

alecs5am/ralphy

When the user needs marketing ideas, inspiration, or strategies for their SaaS or software product. Also use when the user asks for 'marketing ideas,' 'growth ideas,' 'how to market,' 'marketing strategies,' 'marketing tactics,' 'ways to promote,' 'ideas to grow,' 'what else can I try,' 'I don't know how to market this,' 'brainstorm marketing,' or 'what marketing should I do.' Use this as a starting point whenever someone is stuck or looking for inspiration on how to grow. For specific channel execution, see the relevant skill (paid-ads, social-content, email-sequence, etc.).

関連スキル