Communitygithub.com

alecs5am/ralphy

Habilidades para criar anúncios UGC realistas com IA para qualquer produto — fornecendo know-how de nicho generalizado para que o resultado pareça real e não artificial. Um overlay de domínio sobre o pipeline padrão: formato do roteiro de gravação (timestamp | VO | cena | maneirismo), construção da persona do criador, gancho de espelho do problema, regra de confiança através de maneirismos e padrões de formato UGC 9:16 ~15s. Funciona para QUALQUER produto que o usuário nomear — sua linha de cuidados com a pele, um aplicativo sem nome, um gadget. A habilidade fornece o know-how; o usuário fornece o produto.

O que é ralphy?

A habilidade `alecs5am/ralphy` é um guia especializado para criar anúncios UGC (User Generated Content) realistas com IA, voltado para plataformas como TikTok, Reels e Shorts. Ela fornece um overlay de domínio sobre o pipeline padrão de geração, definindo invariantes como o uso de modelos de IA específicos (OpenRouter e ElevenLabs), a obrigatoriedade de referências para produtos de marca real e a criação de personas sintéticas e não baseadas em pessoas reais. O script do anúncio segue uma estrutura de 15 segundos no formato 9:16, com ênfase em um gancho inicial de 'espelho do problema', uma demonstração do produto, um depoimento genuíno e uma chamada para ação. A credibilidade é construída através de maneirismos naturais (risos, gestos), e não por uma entrega polida. A habilidade se diferencia de templates de remix, sendo um guia generalizado para criar anúncios do zero. Ela suporta fluxos de trabalho com geração de persona, keyframes, animação i2v (Kling), narração (ElevenLabs) e música separada, garantindo que o resultado final pareça um vídeo feito por um humano real.

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

Perguntar na sua IA favorita

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

Documentação

Gatilho

DISPARA com um brief genérico de anúncio UGC: "criar um anúncio UGC para ", "creator avaliando meu ", "anúncio de depoimento", "curta de problema/solução para ", "antes/depois para " (quando a ênfase é um creator falando, não uma montagem pura do produto).

NÃO DISPARA quando:

  • O usuário aponta para um anúncio específico para reproduzir → caminho de remix (ralphy template use <slug>). Veja docs/skills-vs-templates.md.
  • O usuário quer apenas trocar o criador/pessoa em um clipe existente → /ugc-model-swap.
  • O brief é um anúncio de imagem estática, não vídeo → esse é um nicho diferente.

O que esta habilidade é

Um overlay generalizado, não um anúncio finalizado. Ela diz ao pipeline COMO anúncios UGC críveis funcionam, para que o roteirista e o diretor de arte produzam um forte para o que o usuário está vendendo. Ela passa através do pipeline normal e nunca ignora os portões de entrada, o portão de referência obrigatória ou os portões de qualidade.

Invariantes rígidos

  • As invariantes do provedor permanecem. Toda geração via ralphy generate (mídia OpenRouter + ElevenLabs apenas — sem FAL, sem Higgsfield, sem Canva, sem API bruta). Renderizações via ralphy render <id>. Leia MODELS.md antes de nomear qualquer id de modelo.
  • Portão de referência. Um produto de marca real nomeado ("iPhone 16", "CeraVe cleanser") dispara o portão de referência obrigatória — recuse sem uma foto de referência ou --no-ref-consent registrado. Um produto genérico/sem nome prossegue sem referência.
  • Rostos de criadores de IA são personas sintéticas, não pessoas reais. Construa um criador consistente e inexistente (veja o fluxo de trabalho). Não faça mistura facial em direção a uma pessoa real reconhecível.
  • Música é uma passagem separada do ElevenLabs. Kling --audio é apenas para o VO/sincronização labial; proíba música no prompt do Kling e sobreponha uma base instrumental na etapa de edição (por MEMORY.md nota Kling-no-music).

O nicho, em um parágrafo

Um anúncio UGC vive ou morre pela credibilidade e pelos primeiros 3 segundos. O espectador deve sentir que uma pessoa real está falando com ele, não uma marca. O gancho é um espelho do problema — mostre ao espectador seu próprio problema para que ele pare de rolar porque se vê. Depois uma batida de transformação/esperança, depois um veredito real, depois uma CTA de baixo atrito. A confiança vem de maneirismos (uma risada nervosa, um tique no cabelo, contato visual direto, apontar para o produto) muito mais do que de uma entrega polida. O maior indicador de IA é um criador perfeito e simétrico demais e uma voz limpa de estúdio — lute contra ambos.

Formato do script / batida (padrão ~15s, 9:16)

Crie um roteiro de gravação como uma tabela que o diretor de arte possa desdobrar:

TimestampLocução (palavras exatas)Visual / cenaAção / maneirismo
0-3sa linha de ganchoproblema mostrado visualmente, creator para a câmeragesto de interrupção de padrão
3-7sa viradaproduto aplicado / usado / demonstradomãos no produto
7-12so vereditoreação / antes-depoisreação genuína (risada, sobrancelhas levantadas)
12-15sa CTAcreator para a câmeraapontar / "link na bio"

Princípios de viralidade a serem incorporados: gancho de espelho do problema, loop de esperança (transformação após o problema), interrupção de padrão de áudio (um efeito sonoro whoosh no corte), maneirismos = confiança, presença do ambiente (um toque de reverb na VO para parecer gravada em um cômodo, não em estúdio), urgência na CTA (específica, de baixo atrito).

Enquadramento + realismo

  • Sensação de smartphone UGC de mão, nível dos olhos, 9:16. Luz natural interna, não flash de celular chapado.
  • Criador fotorrealista. Poros na pele, microdetalhes, leve assimetria — incorpore o registro anti-AI-slop / fotorrealista (ralphy guideline list; veja MEMORY.md notas anti-ai-slop + photoreal-still). Um rosto impecável é a pista.
  • Gere a âncora do criador com o produto na mão ou perto do rosto para a referência do primeiro quadro.

Pilha de modelos padrão (verifique contra MODELS.md)

  • Script: o LLM roteirista (callLLM) — alimente com o máximo de contexto (produto, dores-alvo, padrões virais do nicho, estrutura de gancho escolhida).
  • Keyframes do criador + produto: google/gemini-3-pro-image-preview (nano-banana-pro). Gere 3-5 variantes, escolha a mais realista.
  • i2v (criador falante multi-corte): kwaivgi/kling-v3.0-pro — direcione quadro a quadro (cada corte = criador fala → close-up do produto → reação → CTA). Kling --audio carrega o VO EN + sincronização labial; para não-EN, VO via ElevenLabs (confirme o idioma alvo na entrada — veja MEMORY.md nota Kling-no-RU-audio).
  • Música: passagem separada ElevenLabs Music, instrumental, mixada na pós-produção no editor (sem nomes de artistas — MEMORY.md).
  • Legendas: por slot sobre o VO bloqueado.

Fluxo de trabalho

  1. Entrada. Colete: produto (nome / URL / imagem), público-alvo + suas dores, tipo de gancho (problema-solução / antes-depois / depoimento / transformação — ou deixe o agente escolher), idioma alvo, "nãos" rígidos. Anuncie: "Este é um anúncio UGC — usando a habilidade de anúncio UGC." Padrões: 9:16, ~15s.
  2. Portão de referência. Produto de marca real nomeado → obtenha uma referência ou --no-ref-consent registrado. Sem nome → prossiga.
  3. Script. Produza a tabela do roteiro de gravação com timestamps; obtenha o "vai" do usuário.
  4. Âncora da persona do criador (com o produto), depois âncoras por batida — uma batida de cada vez com pontos de verificação.
  5. i2v por batida (Kling, lista de cenas dirigida), depois VO/SFX, depois pós-mixagem de música, depois legendas, depois ralphy render <id>.
  6. Passe adiante para /evaluator para o portão de qualidade pós-renderização.

Receituário

  • "Crie um anúncio UGC para meu sérum de vitamina C sem nome" → sem referência necessária; gancho de espelho do problema (pele opaca), persona do criador, ~15s 9:16. Combine com esta habilidade, execute o pipeline.
  • "Anúncio de criador para o Dyson Airwrap" → produto real nomeado → portão de referência dispara; peça uma foto de referência primeiro.
  • "Mesmo anúncio, mas com um criador diferente" → NÃO é esta habilidade → /ugc-model-swap.

Veja também

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.

Habilidades Relacionadas