Communitygithub.com

alecs5am/ralphy

關於如何製作逼真的 AI UGC 廣告——通用的利基知識,讓廣告看起來真實且不帶 AI 感。基於標準流程的領域覆蓋層:提供拍攝腳本格式(時間戳 | 旁白 | 鏡頭 | 舉止)、創作者角色建構、問題鏡射鉤子、透過舉止建立信任的規則,以及 9:16 約 15 秒的 UGC 格式預設值。適用於使用者指定的任何產品——他們的保養品系列、無名應用程式、小工具。此技能提供知識;使用者提供產品。

ralphy 是什麼?

這是一個專門用於生成通用使用者生成內容(UGC)廣告的 AI 代理技能,由 alecs5am/ralphy 開發。它為如何製作逼真的、看起來不像 AI 生成的 UGC 廣告(針對 TikTok、Reels 或 Shorts 等短影音平台)提供了一套結構化的框架和規則。此技能並非提供一個固定的廣告模板,而是一個通用的知識覆蓋層,指導標準的 AI 代理流程(如腳本撰寫和藝術指導)產出高品質廣告。核心原則包括:透過問題鏡射鉤子在最初三秒內抓住注意力、透過真實的創作者舉止(如緊張的笑聲、撥弄頭髮)建立信任、以手持智慧型手機的偽紀錄片風格增加真實感,以及建構一個包含「鉤子-轉折-評價-行動呼籲」的約 15 秒拍攝腳本。它明確區分了「從零開始創建廣告」和「複製現有廣告」的情境。此技能支援任何類型的產品,從知名品牌到無名商品都有明確的處理規則(例如,知名產品需要參考圖片),並提供如 Gemini 和 Kling 等模型的預設技術堆疊,最終通過 ralphy 工具鏈渲染輸出。

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

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

觸發條件

啟動於通用的 UGC 廣告簡報:「為 <產品> 製作一支 UGC 廣告」、「創作者評論我的 <產品>」、「見證廣告」、「<應用程式> 的問題/解決方案短片」、「<產品> 的前後對比」(當重點是創作者說話時,而非純產品展示)。

請勿啟動於:

  • 使用者指定要複製某一支特定廣告 → 使用 重製路徑(ralphy template use <slug>)。請參閱 docs/skills-vs-templates.md。
  • 使用者只想替換現有片段中的創作者/人物 → 使用 /ugc-model-swap。
  • 簡報是靜態圖片廣告,非影片 → 這屬於不同的利基。

此技能是什麼

這是一個通用的覆蓋層,而非一個完成的廣告。它告訴流程管道如何製作可信的 UGC 廣告,以便腳本編寫者和藝術指導能為使用者銷售的任何產品產出強勁的廣告。它貫穿常規流程管道,絕不繞過接收關卡、參考資料關卡或品質關卡。

硬性不變規則

  • 供應商不變規則有效。 所有生成皆透過 ralphy generate(僅限 OpenRouter 媒體和 ElevenLabs——無 FAL、無 Higgsfield、無 Canva、無原始 API)。透過 ralphy render <id> 進行渲染。在指定任何模型 ID 前,請閱讀 MODELS.md。
  • 參考資料關卡。 一個有命名的真實品牌產品(「iPhone 16」、「CeraVe 洗面乳」)會觸發參考資料必要關卡——若無參考照片或記錄 --no-ref-consent 則拒絕服務。無名/通用產品則無需參考資料即可進行。
  • AI 創作者臉孔是合成人物,非真人。 建立一個一致的不存在創作者(參見工作流程)。請勿進行臉部混合以接近任何可識別的真人。
  • 音樂是單獨的 ElevenLabs 流程。 Kling 的 --audio 僅用於旁白/唇形同步;在 Kling 提示詞中禁止音樂,並在編輯階段疊加背景器樂(根據 MEMORY.md 中的 Kling 無音樂備註)。

利基,一句話說明

UGC 廣告的成敗取決於可信度和前 3 秒。觀看者必須感覺到是一個真實的人在對他們說話,而不是一個品牌。鉤子是一個問題鏡射——展示觀看者自己的問題,使他們因為看到自己而停止滑動。接著是一個轉變/希望節拍,然後是真實評價,最後是一個低門檻的行動呼籲。信任來自舉止(緊張的笑聲、撥弄頭髮、直接的眼神接觸、指向產品),遠勝過於完美的表達。最大的 AI 破綻是一個過於完美、過於對稱的創作者和錄音室般乾淨的聲音——兩者都要避免。

節拍 / 腳本結構(預設約 15 秒,9:16)

撰寫一個可供藝術指導展開的拍攝腳本表格:

時間戳旁白(確切用詞)視覺 / 鏡頭動作 / 舉止
0-3s鉤子台詞視覺化呈現問題,創作者對著鏡頭模式中斷手勢
3-7s轉折產品塗抹/使用/展示手在產品上
7-12s評價反應 / 前後對比真實反應(笑、挑眉)
12-15s行動呼籲創作者對著鏡頭指向 /「簡介中有連結」

要融入的病毒式傳播原則:問題鏡射鉤子、希望迴圈(問題後的轉變)、音訊模式中斷(剪輯處的嗖聲 SFX)、舉止 = 信任、空間感(旁白加入一點殘響,使其聽起來像在房間錄製,而非錄音室)、行動呼籲的急迫感(具體、低門檻)。

架構 + 真實感

  • 手持智慧型手機 UGC 感覺,視線高度,9:16。自然室內光,非平板手機閃光燈。
  • 照片級真實創作者。 皮膚毛孔、微細節、輕微不對稱——採用反 AI 垃圾/照片級靜態風格(ralphy guideline list;參見 MEMORY.md 中的反 AI 垃圾 + 照片級靜態備註)。完美的臉龐就是破綻。
  • 生成創作者錨點時,讓產品拿在手中或靠近臉部,作為第一影格的參考。

預設模型堆疊(請與 MODELS.md 核對)

  • 腳本: 腳本編寫者 LLM(callLLM)——提供最大上下文(產品、目標痛點、該利基的病毒式模式、選擇的鉤子框架)。
  • 創作者 + 產品關鍵影格: google/gemini-3-pro-image-preview(nano-banana-pro)。生成 3-5 個變體,選擇最逼真的。
  • 圖生影片(多鏡頭說話創作者): kwaivgi/kling-v3.0-pro——逐鏡頭指導它(每個剪輯 = 創作者說話 → 產品特寫 → 反應 → 行動呼籲)。Kling 的 --audio 承載英文旁白 + 唇形同步;非英文則透過 ElevenLabs 處理旁白(在接收時確認目標語言——參見 MEMORY.md 中的 Kling 無俄語音訊)。
  • 音樂: 單獨的 ElevenLabs Music 流程,器樂,在編輯器中後期混音(無藝術家姓名——MEMORY.md)。
  • 字幕: 在鎖定的旁白上按時間分配。

工作流程

  1. 接收。 收集:產品(名稱 / 網址 / 圖片)、目標受眾及其痛點、鉤子類型(問題-解決方案 / 前後對比 / 見證 / 轉變——或讓代理選擇)、目標語言、硬性「不」要求。宣告:「這是一支 UGC 廣告——使用 UGC 廣告技能。」預設值:9:16,約 15 秒。
  2. 參考資料關卡。 有命名的真實品牌產品 → 取得參考照片或記錄 --no-ref-consent。無名產品 → 繼續。
  3. 腳本。 產出帶時間戳的拍攝腳本表格;取得使用者的「開始」確認。
  4. 創作者角色錨點(與產品一起),然後逐節拍錨點——一次一個節拍並設定檢查點。
  5. 逐節拍圖生影片(Kling,有指導的鏡頭列表),然後旁白/SFX,接著音樂後期混音,然後字幕,最後 ralphy render <id>。
  6. 交接給 /evaluator 進行渲染後的品質檢查關卡。

範例

  • 「為我的無名維生素 C 精華製作一支 UGC 廣告」 → 無需參考資料;問題鏡射鉤子(暗沉肌膚)、創作者角色、約 15 秒 9:16。符合此技能,執行流程管道。
  • 「為 Dyson Airwrap 創作者廣告」 → 有命名的真實產品 → 觸發參考資料關卡;先要求提供參考照片。
  • 「同一廣告但換一個不同的創作者」 → 不屬此技能 → 使用 /ugc-model-swap。

參見

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.

相關技能