Communitygithub.com

alecs5am/ralphy

실제 같은 AI UGC 광고를 제작하는 방법 — 진짜 같고 AI 티가 나지 않는 일반화된 틈새 노하우. 표준 파이프라인에 도메인 오버레이를 제공: 촬영 대본 형식(타임스탬프 | VO | 샷 | 매너리즘), 크리에이터 페르소나 구축, 문제-거울 훅, 매너리즘을 통한 신뢰 규칙, 9:16 ~15초 UGC 형식 기본값을 제공합니다. 사용자가 지정한 모든 제품(스킨케어 라인, 무명 앱, 가젯)에서 작동합니다. 이 스킬은 노하우를 제공하며, 사용자는 제품을 제공합니다.

ralphy란 무엇인가요?

이 스킬은 Claude Code, Cursor, Codex 등 AI 에이전트 파이프라인을 위한 일반화된 UGC 광고 제작 노하우 오버레이입니다. 사용자가 특정 제품(브랜드 제품 또는 무명 제품 모두 가능)에 대한 '진짜 같은' 크리에이터 스타일 광고를 요청할 때 활성화됩니다. 핵심은 **자연스러움**과 **처음 3초**에 있습니다. 문제-거울 훅, 매너리즘(긴장된 웃음, 머리카락 정리 등)을 통한 신뢰 구축, 완벽하지 않은 크리에이터 페르소나를 강조하여 AI 감을 제거합니다. 스킬은 타임스탬프 기반 촬영 대본(기본 ~15초, 9:16), 크리에이터+제품 키프레임 생성(Google Gemini 3 Pro), Kling V3.0 Pro를 사용한 샷별 i2v, ElevenLabs VO 및 음악 분리, 최종 편집 단계를 포함한 전체 워크플로우를 제공합니다. 하드 불변 규칙으로는 OpenRouter/ElevenLaks만 사용, 실제 브랜드 제품은 참조 사진 필수, AI 크리에이터는 가상 페르소나(실제 인물 혼합 금지), Kling에서 음악 금지 등이 있습니다. 특정 기존 광고를 재현해야 하는 경우(remix 경로)나 크리에이터만 교체하는 경우(/ugc-model-swap)에는 이 스킬이 적합하지 않습니다.

지원 대상✓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 미디어 + ElevenLabs만 — FAL, Higgsfield, Canva, 원시 API 금지). 렌더링은 ralphy render <id>를 통해. 모델 ID를 지명하기 전에 MODELS.md를 읽으십시오.
  • 참조 게이트. 명명된 실제 브랜드 제품("iPhone 16", "CeraVe 클렌저")은 참조 필수 게이트를 발동시킵니다 — 참조 사진이나 기록된 --no-ref-consent 없이는 거부하십시오. 무명/일반 제품은 참조 없이 진행됩니다.
  • AI 크리에이터 얼굴은 실제 사람이 아닌 합성 페르소나입니다. 일관된 비존재 크리에이터를 구축하십시오(워크플로우 참조). 알아볼 수 있는 실제 사람을 향해 얼굴을 혼합하지 마십시오.
  • 음악은 별도의 ElevenLabs 패스입니다. Kling --audio는 VO/립싱크 전용입니다. Kling 프롬프트에서 음악을 금지하고 편집 단계에서 악기 배경음을 오버레이하십시오(MEMORY.md Kling-음악-금지 노트 참조).

틈새, 한 문단으로

UGC 광고의 성패는 신뢰성과 처음 3초에 달려 있습니다. 시청자는 브랜드가 아닌 실제 사람이 자신에게 말을 걸고 있다고 느껴야 합니다. 훅은 문제 거울입니다 — 시청자가 자신의 문제를 보게 하여 스크롤을 멈추도록 만드십시오. 그런 다음 변화/희망 비트, 실제 평가, 낮은 마찰의 CTA로 이어집니다. 신뢰는 세련된 전달보다 매너리즘(긴장된 웃음, 머리 정리, 직접적인 눈맞춤, 제품 가리키기)에서 훨씬 더 많이 비롯됩니다. 가장 큰 AI 티는 너무 완벽하고 대칭적인 크리에이터와 스튜디오처럼 깨끗한 목소리입니다 — 둘 다 싸워야 합니다.

비트 / 대본 형식 (기본 ~15초, 9:16)

아트 디렉터가 펼쳐볼 수 있는 표 형태로 촬영 대본을 작성하십시오:

타임스탬프보이스오버 (정확한 대사)시각 / 샷동작 / 매너리즘
0-3초훅 대사문제를 시각적으로 보여주고, 크리에이터가 카메라를 향함패턴 중단 제스처
3-7초전환제품 적용 / 사용 / 데모제품 위에 손
7-12초평가반응 / 비포-애프터진짜 반응 (웃음, 눈썹 치켜올림)
12-15초CTA크리에이터가 카메라를 향함가리키기 / "링크 인 바이오"

내장할 바이럴 원칙: 문제-거울 훅, 희망 루프(문제 이후 변화), 오디오 패턴 중단(컷에 휙 SFX), 매너리즘 = 신뢰, 공간감(VO에 약간의 리버브를 추가하여 스튜디오가 아닌 방에서 녹음된 느낌), CTA 긴박감(구체적이고 낮은 마찰).

프레이밍 + 사실감

  • 핸드헬드 스마트폰 UGC 느낌, 눈높이, 9:16. 자연광 실내 조명, 평평한 폰 플래시 금지.
  • 포토리얼 크리에이터. 피부 모공, 미세 디테일, 약간의 비대칭 — AI-슬롭 방지 / 포토리얼 스틸 레지스터를 적용하십시오 (ralphy guideline list; MEMORY.md AI-슬롭-방지 + 포토리얼-스틸 노트 참조). 결점 없는 얼굴은 티입니다.
  • 첫 프레임 참조를 위해 크리에이터 앵커를 제품을 손에 들거나 얼굴 근처에 생성하십시오.

기본 모델 스택 (MODELS.md와 대조하여 확인)

  • 대본: 시나리오 작가 LLM (callLLM) — 최대 컨텍스트(제품, 타겟 고통, 틈새의 바이럴 패턴, 선택된 훅 프레임워크)를 제공하십시오.
  • 크리에이터 + 제품 키프레임: google/gemini-3-pro-image-preview (나노-바나나-프로). 3-5개 변형을 생성하고 가장 사실적인 것을 선택하십시오.
  • i2v (멀티샷 말하는 크리에이터): kwaivgi/kling-v3.0-pro — 샷별로 직접 지시하십시오 (각 컷 = 크리에이터 말하기 → 제품 클로즈업 → 반응 → CTA). Kling --audio는 EN VO + 립싱크를 처리합니다. 비-EN의 경우 VO는 ElevenLabs를 통해 (수집 시 타겟 언어 확인 — MEMORY.md Kling-러시아어-오디오-금지 참조).
  • 음악: 별도의 ElevenLabs 음악 패스, 악기 전용, 편집기에서 포스트 믹싱 (아티스트 이름 금지 — MEMORY.md).
  • 자막: 고정된 VO에 슬롯별로.

워크플로우

  1. 수집. 수집: 제품 (이름 / URL / 이미지), 타겟 오디언스 + 그들의 고통, 훅 유형 (문제-해결 / 비포-애프터 / 증언 / 변화 — 또는 에이전트가 선택하도록 함), 타겟 언어, 하드 "안 됨". 공지: "이것은 UGC 광고입니다 — UGC-광고 스킬을 사용합니다." 기본값: 9:16, ~15초.
  2. 참조 게이트. 명명된 실제 브랜드 제품 → 참조 또는 기록된 --no-ref-consent를 받으십시오. 무명 → 진행.
  3. 대본. 타임스탬프가 있는 촬영 대본 표를 작성하고 사용자의 "승인"을 받으십시오.
  4. 크리에이터 페르소나 앵커 (제품 포함), 그런 다음 비트별 앵커 — 체크포인트와 함께 한 번에 하나의 비트.
  5. 비트별 i2v (Kling, 지시된 샷 리스트), 그런 다음 VO/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.

관련 스킬