Communitygithub.com

alecs5am/ralphy

실제 같고 AI 티 나지 않는 15초 UGC 광고 제작을 위한 완전한 엔드투엔드 워크플로우를 제공합니다.

ralphy란 무엇인가요?

이 스킬은 제품의 현실감 있는 AI UGC 광고를 15초 형식으로 생성하는 완전한 엔드투엔드 파이프라인을 제공합니다. 제품 정보, 참고 UGC 비디오, 창작자 얼굴 참조 이미지(2장 이상), 타겟 청중, 후크 유형 등 필요한 모든 입력을 사용자에게 수집한 후 스크립트 작성부터 얼굴 생성, 비디오 생성까지의 단계를 안내합니다. Claude Sonnet 4.6을 사용한 강력한 스크립트 작성, Nano Banana Pro를 사용한 4K 현실적인 창작자 얼굴 생성, Kling 3.0을 사용한 15초 멀티샷 비디오 생성을 지원합니다. 주요 플랫폼으로는 Higgsfield, Fal.ai, Google AI Studio, Kling AI 웹사이트, Canva, ElevenLabs 등이 있으며, 각 단계마다 입증된 바이럴 원칙(문제 거울 후크, 비포/애프터 희망 루프, 오디오 후크, 창작자 매너리즘을 통한 신뢰 구축)이 내장되어 있어 일반인 UGC와 구분하기 어려운 고품질 광고를 제작할 수 있습니다.

지원 대상✓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세 여성)
  • 후크 유형 — 문제/해결, 전/후, 사용 후기, 변화, 또는 에이전트가 제품에 따라 결정하도록 함
  • 절대 묻지 말 것
    • 사용할 편집 도구 (항상 Canva)
    • 비디오 길이 (항상 15초)
    • 화면 비율 (항상 9:16 세로)
    • 사용할 비디오 모델 (항상 Kling 3.0)
    • 사용할 이미지 모델 (항상 Nano Banana Pro)
  • 1단계 — 스크립트 작성 (Claude 4.6)
    • 도구: Claude claude-sonnet-4-6 (강력한 추론 + 창의적 글쓰기 — 최대한 많은 맥락 제공)

프롬프트 템플릿:

[참고 비디오]와 비슷하지만 [제품]에 대한 15초 비디오를 위한 UGC 스크립트를 만드세요. UGC 창작자/화자로 [얼굴 참조 이미지에서 추출한 창작자 설명]을 사용하세요. 포함할 내용:

  • 후크 (처음 3-5초): 문제를 시각적으로 보여주기 + 오디오 후크
  • 정확한 단어가 포함된 나레이션 대사
  • 컷 설명: 각 순간에 카메라가 보여주는 것 (창작자 얼굴, 제품, 전/후 등)
  • 동작 및 매너리즘: 창작자를 실제 캐릭터처럼 느끼게 만듦 — 긴장된 웃음, 머리 넘기기, 직접적인 눈맞춤, 제품 가리키기 등
  • 클릭 유도 문구 (마지막 2-3초)
  • 각 컷/동작의 타임스탬프 타임스탬프 | 나레이션 | 시각/샷 | 동작/매너리즘 열이 있는 촬영 스크립트로 출력하세요.

참고사항:

  • Claude에 최대 맥락 제공: 참고 비디오 URL, 제품 세부 정보, 타겟 청중의痛点, 해당 분야의 다른 바이럴 UGC 비디오, 스토리텔링 프레임워크 (문제-자극-해결, 전/후 등)
  • 맥락이 많을수록 스크립트가 좋아집니다. Claude의 추론 능력이 여기서 장점입니다.
  • 내장할 바이럴 원칙: 패턴 인터럽트 후크, 사회적 증거, 변화 순간, 긴급성 CTA
  • 출력: 타임스탬프, 나레이션, 시각적 요소, 창작자 매너리즘이 포함된 촬영 스크립트

2단계 — 창작자 얼굴 생성 (Nano Banana Pro)

  • 도구: Nano Banana Pro (4K — 현실적인 피부 질감, 모공, 디테일에 필수)

프롬프트 템플릿:

이 두 얼굴을 혼합하여 실제 사람에게 속하지 않는 새로운 매력적인 얼굴을 만드세요. 결과를 UGC 뷰티/라이프스타일 콘텐츠 창작자의 얼굴로 사용하세요. 4K 해상도로 생성하세요. 초현실적인 피부 질감, 자연광, 창작자가 링라이트 마이크를 들고 있는 모습.

참고사항:

  • 브랜드 개성에 맞는 2장 이상의 Pinterest/스톡 얼굴 참조 이미지 사용 (공감 가는, 포부 있는, 분야에 적합한)
  • 첫 프레임 참조용으로 제품을 손에 들거나 얼굴 근처에 두고 생성
  • 피부 모공, 미세 디테일, 자연스러운 결점이 필요 — 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. 무료 테스트: 쿠폰 pixelriot20hackathon-fal 사용 Fal.ai
  • 플랫폼: Higgsfield, 공식 Kling AI 웹사이트, Fal.ai
  • 출력: 15초 원본 비디오 클립

바이럴 원칙 (모든 단계에 내장)

후크 = 문제 거울: 처음 3초 안에 시청자에게 자신의 문제를 보여줍니다. 자신의 모습을 보기 때문에 스크롤을 멈춥니다. 전/후 = 희망 루프: 문제 후크 후 변화를 보여줍니다. 이는 욕구를 창출합니다. 오디오 후크: 컷에서의 우웅 SFX는 패턴 인터럽트로 시청 시간을 유지합니다. 창작자 매너리즘 = 신뢰: 실제 사람처럼 느껴지는 창작자 (긴장된 웃음, 머리 넘기기, 한숨)는 완벽한 전달보다 빠르게 무의식적 신뢰를 구축합니다. 리버브 = 공간감: 10% 리버브는 목소리가 스튜디오가 아닌 실제 공간에서 녹음된 것처럼 느끼게 합니다. "AI 라디오 목소리" 느낌을 제거합니다. CTA 긴급성: 마지막 2-3초. 직접적이고, 구체적이며, 마찰이 적습니다 ("링크 인 바이오", "링크 탭", "DM").

브랜딩 참고사항

실제 계정/브랜드용인 경우 (테스트 아님):

  • 창작자 얼굴은 브랜드 타겟 청중 페르소나와 일치해야 함
  • 창작자의 스타일/분위기는 모든 UGC 비디오에서 일관되어야 함

비디오 간에 미학을 혼합하지 말고 하나를 선택하여 고정하세요.

플랫폼 / 비용 요약

도구목적비용
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.).

관련 스킬