Communitygithub.com

alecs5am/ralphy

Fluxo de trabalho completo para gerar um anúncio UGC de IA realista para um produto. Formato de 15 segundos. Parece real. Não parece IA.

O que é ralphy?

O skill Ralphy fornece um pipeline completo de produção de anúncios UGC (conteúdo gerado por usuário) com IA, gerando vídeos de 15 segundos que parecem autênticos e não artificiais. Ele guia o usuário desde a coleta de informações do produto, vídeo de referência, imagens de rosto do criador e público-alvo, até a escrita do roteiro usando Claude Sonnet 4.6, geração de rosto do criador com Nano Banana Pro em 4K, e produção do vídeo com Kling 3.0 (modelo multi-shot de 15 segundos). O pipeline enfatiza princípios de viralidade como gancho como espelho do problema, transformação antes/depois, maneirismos realistas do criador (risada nervosa, colocar o cabelo atrás da orelha) e reverb de 10% para dar presença ambiente. Suporta plataformas como Higgsfield, Fal.ai (com cupom de desconto), Google AI Studio e Kling AI, e integra edição final com Canva. O resultado é um anúncio UGC que parece filmado por um criador real, com rosto gerado por IA que não pertence a nenhuma pessoa real, aumentando a confiança e o engajamento.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Pipeline de Produção de Anúncio UGC

Entradas Necessárias (peça TODAS estas ao usuário antes de começar)

Antes de gerar qualquer coisa, colete:

  • Produto — o que está sendo anunciado (nome, URL ou imagem)
  • Vídeo UGC de referência — um vídeo UGC real no mesmo nicho/estilo (link do Pinterest, TikTok, YouTube). Usado para estilo do roteiro, personalidade do criador e referência de cena.
  • Referências de rosto do criador — 2+ imagens de pessoas reais (atraentes, combinando com a vibe da marca). Essas serão misturadas no Nano Banana Pro para criar um novo criador que não existe.
  • Público-alvo — para quem é o anúncio (ex.: mulheres 18-35 com pele propensa a acne)
  • Tipo de gancho — problema/solução, antes/depois, depoimento, transformação, ou deixe o agente decidir com base no produto
  • NUNCA pergunte:
    • Qual ferramenta de edição usar (sempre Canva)
    • Duração do vídeo (sempre 15 segundos)
    • Proporção de tela (sempre 9:16 vertical)
    • Qual modelo de vídeo (sempre Kling 3.0)
    • Qual modelo de imagem (sempre Nano Banana Pro)

Etapa 1 — Escrita do Roteiro (Claude 4.6)

Ferramenta: Claude claude-sonnet-4-6 (forte raciocínio + escrita criativa — alimente-o com o máximo de contexto possível)

Modelo de prompt:

Crie um roteiro UGC para um vídeo de 15 segundos como [VÍDEO DE REFERÊNCIA] mas para [PRODUTO]. Use [DESCRIÇÃO DO CRIADOR a partir das referências de rosto] como o criador/apresentador UGC. Inclua:

  • Gancho (primeiros 3-5 segundos): mostre o problema visualmente + gancho de áudio
  • Falas do locutor com as palavras exatas
  • Descrições de corte: o que a câmera mostra em cada momento (rosto do criador, produto, antes/depois, etc.)
  • Ações e maneirismos: faça o criador parecer um personagem real — risada nervosa, colocar o cabelo atrás da orelha, contato visual direto, apontar para o produto, etc.
  • Chamada para ação (últimos 2-3 segundos)
  • Carimbos de tempo para cada corte/ação Saída como um roteiro de filmagem com colunas: Carimbo de Tempo | Locução | Visual/Cena | Ação/Maneirismo

Notas:

  • Dê a Claude o máximo de contexto: URL do vídeo de referência, detalhes do produto, pontos de dor do público-alvo, outros vídeos UGC virais no nicho, frameworks de storytelling (problema-agita-resolve, antes/depois, etc.)
  • Quanto mais contexto, melhor o roteiro. A capacidade de raciocínio de Claude é a vantagem aqui.
  • Princípios de viralidade a serem incorporados: gancho de interrupção de padrão, prova social, momento de transformação, CTA de urgência
  • Saída: Um roteiro de filmagem com carimbos de tempo, locução, visuais e maneirismos do criador.

Etapa 2 — Gerar o Rosto do Criador (Nano Banana Pro)

Ferramenta: Nano Banana Pro (4K — necessário para textura de pele realista, poros, detalhes)

Modelo de prompt:

Misture estas duas faces para criar um novo rosto atraente que não pertence a nenhuma pessoa real. Use o resultado como o rosto de um criador de conteúdo UGC de beleza/estilo de vida. Gere em resolução 4K. Textura de pele hiper-realista, iluminação natural, criador segurando um microfone com anel de luz.

Notas:

  • Use 2+ referências de rosto do Pinterest/stock que combinem com a personalidade da marca (relacionável, aspiracional, adequado ao nicho)
  • Gere com o produto na mão ou perto do rosto para a referência do primeiro quadro
  • Você quer poros de pele, microdetalhes, imperfeições naturais — isso é o que faz não parecer IA
  • Opções de plataforma (do mais barato ao melhor):
    • Higgsfield (plano criador) — freemium, funciona
    • Fal.ai — use o cupom pixelriot20hackathon-fal para $20 de créditos grátis
    • Google AI Studio — pago, mais controle
  • Gere 3-5 variantes, escolha a mais realista
  • Saída: Uma imagem de retrato 4K do criador IA segurando o produto.

Etapa 3 — Gerar o Vídeo (Kling 3.0)

Ferramenta: Kling 3.0 (modelo multi-shot de 15 segundos)

Por que Kling 3.0:

  • Duração nativa de saída de 15 segundos
  • Multi-shot: pode cortar entre criador falando → close do produto → transformação da pele → de volta ao criador
  • Expressivo: entende maneirismos do criador, gestos, personalidade
  • Tem compreensão contextual de plataformas de conteúdo (nativo UGC)

Configuração:

  • Entrada: imagem do criador (Etapa 2) como quadro inicial
  • Entrada: imagem do produto como imagem de referência (não necessariamente quadro inicial — pode ser referência no meio do vídeo)
  • Entrada: roteiro de filmagem (Etapa 1) como prompt de movimento/cena

Estrutura do prompt:

[Primeiro quadro: criador segurando o produto, olhando para a câmera, iluminação natural] Corte 1 (0-3s): Criador fala diretamente para a câmera com [maneirismo], diz "[fala do gancho]" Corte 2 (3-7s): Close do produto sendo aplicado / usado na pele Corte 3 (7-12s): Cena de reação do criador — [emoção/maneirismo do roteiro] Corte 4 (12-15s): Criador olha para a câmera, entrega CTA, [maneirismo]

Notas:

  • Controlar cenas = dizer exatamente o que cada corte mostra. Isso não é apenas prompt — é direção.
  • Multi-shot = você descreve os cortes como um diretor, não como um promptador
  • Se estiver confuso: assista a um tutorial de multi-shot do Kling 3.0 antes de tentar
  • Custo: ~$4-5 por clipe de 15s. Teste grátis: Fal.ai com cupom pixelriot20hackathon-fal
  • Plataformas: Higgsfield, site oficial do Kling AI, Fal.ai
  • Saída: Um clipe de vídeo bruto de 15 segundos.

Princípios de Viralidade (Incorpore em Cada Etapa)

  • Gancho = Espelho do Problema: Mostre ao público o próprio problema nos primeiros 3 segundos. Eles param de rolar porque se veem.
  • Antes/Depois = Loop de Esperança: Após o gancho do problema, mostre a transformação. Isso cria desejo.
  • Gancho de Áudio: O efeito sonoro "whoosh" no corte é uma interrupção de padrão — mantém o tempo de visualização.
  • Maneirismos do Criador = Confiança: Um criador que parece uma pessoa real (ri nervosamente, coloca o cabelo atrás da orelha, suspira) constrói confiança subconsciente mais rápido do que uma entrega perfeita.
  • Reverb = Presença de Ambiente: 10% de reverb faz a voz parecer gravada em um espaço real, não em um estúdio. Remove a sensação de "voz de IA de rádio".
  • Urgência no CTA: Últimos 2-3 segundos. Direto, específico, de baixo atrito ("link na bio", "toque no link", "me mande um DM").

Nota de Branding

Se isso for para uma conta/marca real (não teste):

  • O rosto do criador deve corresponder à persona do público-alvo da marca
  • O estilo/vibe do criador deve ser consistente em todos os vídeos UGC

Não misture estéticas entre vídeos — escolha uma e mantenha-se fiel

Resumo de Plataforma / Custo

FerramentaPropósitoCusto
Gemini 2.5 ProEscrita de roteiroGrátis (AI Studio)
Nano Banana ProRosto do criador + imagens do produtoPlano criador Higgsfield / Fal.ai (cupom de $20: pixelriot20hackathon-fal)
Kling 3.0Geração de vídeo~$4-5/clipe — Higgsfield / Kling AI / Fal.ai
ElevenLabsClonagem + troca de vozPago (recurso de treinamento de voz)
Play.htClonagem de voz (alternativa)Freemium
CanvaEdição de vídeo + textoGrátis / Pro
ArtlistEfeitos sonorosPago (existem alternativas grátis)

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

Habilidades Relacionadas