Communitygithub.com

alecs5am/ralphy

リアルなAI UGC広告の作り方を提供する汎用スキル。撮影台本のテンプレート、クリエイターペルソナの構築、問題ミラーフック、信頼を生む仕草のルール、9:16・約15秒のUGCフォーマットを標準装備。ユーザーが任意の製品(スキンケア、無名のアプリ、ガジェットなど)を指定して利用できる。

ralphy とは?

このスキルは、ユーザーが指定した製品に対して、まるで本物の人間がレビューしているかのようなリアルなUGC広告を生成するための汎用的なナレッジオーバーレイです。スキルを適用すると、問題提起→解決策の提示→本音の評価→CTAという構成の台本を自動生成し、OpenRouterやElevenLabsなどの指定されたモデルスタックを使って、肌の質感や非対称性を備えたフォトリアルなクリエイター動画を生成します。重要なのは、初動3秒での「問題ミラー」フックと、緊張した笑顔や髪を触る仕草といった「人間らしいクセ」で信頼感を演出する点です。対応プラットフォームはTikTok、Reels、Shortsを想定し、9:16・約15秒の縦型動画フォーマットに最適化されています。「この特定の広告を真似してほしい」というリミックス依頼や、既存クリップのクリエイター差し替えとは異なり、あくまで製品からゼロベースでUGC広告を生成するためのスキルです。

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

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

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

ドキュメント

トリガー

発動条件 汎用的なUGC広告の依頼時: 「<製品>のUGC広告を作って」「<製品>をレビューするクリエイター」「紹介広告」「<アプリ>の問題解決ショート」「<製品>のビフォーアフター」(強調されるのが、単なる製品モンタージュではなく、話すクリエイターである場合に発動)。

発動しない条件:

  • ユーザーが特定の既存広告を指定して再現を依頼した場合 → リミックスパス(ralphy template use <スラッグ>)を使用。詳細は docs/skills-vs-templates.md を参照。
  • 既存のクリップ内のクリエイター/人物のみを差し替えたい場合 → /ugc-model-swap を使用。
  • 依頼が静止画広告であり、動画でない場合 → これは別のニッチ領域となる。

このスキルの概要

このスキルは、完成された広告そのものではなく、汎用的なオーバーレイ(知識レイヤー)です。パイプラインに対し、信頼性のあるUGC広告がどのように機能するかを指示し、シナリオライターとアートディレクターがユーザーの販売する製品に対して効果的な広告を生成できるようにします。このスキルは通常のパイプラインを通じて動作し、インテークゲート、参照必須ゲート、品質ゲートをバイパスすることはありません。

固定不変条件

  • プロバイダーの不変条件は優先される。 すべての生成は ralphy generate 経由(OpenRouterメディア + ElevenLawsのみ — FAL、Higgsfield、Canva、生のAPIは使用不可)。レンダリングは ralphy render <id> を使用する。モデルIDを指定する前に MODELS.md を読むこと。
  • 参照ゲート。 名前のある本物のブランド製品(「iPhone 16」「CeraVe クレンザー」)は参照必須ゲートを発動 — 参照写真がない場合、または --no-ref-consent が記録されていない場合は拒否する。無名/汎用品の場合は参照なしで進める。
  • AIクリエイターの顔は合成ペルソナであり、実在の人物ではない。 一貫性のある非実在のクリエイターを構築すること(ワークフロー参照)。実在の人物を認識できるレベルに顔を合成してはならない。
  • 音楽は別途ElevenLabsパスで作成する。 Klingの --audio は音声VO/リップシンク専用。Klingのプロンプト内で音楽を禁止し、編集段階でインストゥルメンタルBGMを重ねる(MEMORY.md のKling-音楽禁止の注記に従うこと)。

ニッチ領域を一文で

UGC広告の成否は信頼性と初動3秒にかかっています。視聴者は、ブランドではなく、本物の人間が話しかけてくれていると感じる必要があります。フックは問題ミラー — 視聴者自身の問題を見せ、自分自身を投影してスクロールを止めさせる。次に変化/希望のビート、そして本音の評価、最後に低抵抗なCTAへ。信頼感は、洗練された話し方よりも、仕草(緊張した笑い、髪を触る、アイコンタクト、製品を指さす)によって生まれます。最大のAIらしさの兆候は、完璧すぎる左右対称のクリエイターフェイスと、スタジオで録音したようなクリーンすぎる声です。両方を抑制しましょう。

ビート / 台本のテンプレート(デフォルト約15秒、9:16)

アートディレクターが展開できるよう、撮影台本をテーブル形式で作成します。

タイムスタンプナレーション(正確な文言)映像 / ショットアクション / 仕草
0-3秒フックとなるセリフ問題を視覚的に表示、クリエイターはカメラ目線パターンインタラプトのジェスチャー
3-7秒転換のセリフ製品を適用/使用/デモ製品に手を触れる
7-12秒評価のセリフリアクション / ビフォーアフター自然なリアクション(笑い、眉を上げる)
12-15秒CTAのセリフクリエイターはカメラ目線指さし / 「リンクはプロフィールに」

組み込むべきバイラル原則: 問題ミラーフック、希望ループ(問題の後に変化)、オーディオのパターンインタラプト(カットに合わせてスウッシュSE)、仕草=信頼、部屋の存在感(VOに少しリバーブをかけ、スタジオではなく部屋で録音したように)、CTAの緊急性(具体的で、低抵抗)。

フレーミング + リアリズム

  • スマートフォンで手撮りしたようなUGC感、アイレベル、9:16。自然な室内光、フラットなスマホフラッシュは避ける。
  • フォトリアルなクリエイター。 毛穴、微細ディテール、わずかな非対称性 — AIスランプ防止 / フォトリアル静止画レジスターを適用する(ralphy guideline list; MEMORY.md のAnti-AIスランプ + フォトリアル静止画の注記を参照)。完璧な顔はAIと見破られる。
  • クリエイターのアンカー画像は、製品を手に持つか顔の近くに置いて生成し、最初のフレームの参照とする。

デフォルトのモデルスタック(MODELS.md と照合すること)

  • 台本: シナリオライターLLM(callLLM) — 最大コンテキストを入力(製品、ターゲットの悩み、このニッチのバイラルパターン、選択したフックフレームワーク)。
  • クリエイター + 製品キーフレーム: google/gemini-3-pro-image-preview(nano-banana-pro)。3~5バリエーションを生成し、最もリアルなものを選ぶ。
  • i2v(マルチショットで話すクリエイター): kwaivgi/kling-v3.0-pro — ショットごとに指示(各カット=クリエイターが話す → 製品クローズアップ → リアクション → CTA)。Klingの --audio は英語VO + リップシンクを担当。非英語の場合、VOはElevenLabs経由(インテーク時にターゲット言語を確認 — MEMORY.md のKling-ロシア語音声禁止を参照)。
  • 音楽: 別途ElevenLabs Musicパスでインストゥルメンタルを作成。エディターでポストミックス(アーティスト名は禁止 — MEMORY.md)。
  • キャプション: 確定したVOにタイムスロット単位で追加。

ワークフロー

  1. インテーク. 以下を収集: 製品(名前 / URL / 画像)、ターゲットオーディエンスとその悩み、フックの種類(問題解決 / ビフォーアフター / 紹介 / 変化 — またはエージェントに選択させる)、ターゲット言語、明確な禁止事項。告知: 「これはUGC広告です — UGC広告スキルを使用します。」 デフォルト: 9:16、約15秒。
  2. 参照ゲート. 名前のある本物のブランド製品 → 参照写真を入手するか、--no-ref-consent を記録する。無名製品 → そのまま進める。
  3. 台本. タイムスタンプ付きの撮影台本テーブルを作成し、ユーザーの「GO」を得る。
  4. クリエイターペルソナのアンカー画像(製品と共に)、続いてビートごとのアンカー画像 — 1ビートずつチェックポイントを挟む。
  5. ビートごとにi2v(Kling、ショットリストを指示)、次にVO/SFX、次に音楽ポストミックス、次にキャプション、最後に ralphy render <id>。
  6. /evaluator に引き継ぎ、レンダリング後の品質ゲートを実行。

クックブック

  • 「無名のビタミンCセラムのUGC広告を作って」 → 参照不要。問題ミラーフック(くすみ肌)、クリエイターペルソナ、約15秒 9:16。このスキルに適合、パイプラインを実行。
  • 「Dyson Airwrapのクリエイター広告」 → 名前のある本物の製品 → 参照ゲート発動。まず参照写真を依頼する。
  • 「同じ広告だけど別のクリエイターで」 → このスキルではない → /ugc-model-swap を使用する。

関連情報

  • docs/skills-vs-templates.md — スキルとリミックステンプレートの違い。
  • .agents/skills/intake/SKILL.md — このスキルが通過するゲート。
  • MEMORY.md — Anti-AIスランプ、フォトリアル静止画レジスター、Klingの音楽ポストミックス禁止、Klingのロシア語音声禁止。

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

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.).

alecs5am/ralphy

Full end-to-end workflow for generating a realistic AI UGC ad for a product. 15-second format. Looks real. Doesn't feel AI.

関連スキル