Communitygithub.com

alecs5am/ralphy

Cómo crear un anuncio UGC realista con IA para cualquier producto: un conocimiento generalizado que se ve real y no parece generado por IA. Proporciona la estructura del guion de rodaje (marca de tiempo | VO | plano | gesto), la construcción de la persona del creador, el gancho de espejo del problema, la regla de confianza a través de gestos y los formatos predeterminados UGC de 9:16 y ~15s. Funciona para CUALQUIER producto que mencione el usuario: su línea de cuidado de la piel, una aplicación sin nombre, un gadget. La skill aporta el conocimiento; el usuario aporta el producto.

¿Qué es ralphy?

Esta habilidad (skill) para agentes de IA, como Claude Code, Cursor o Codex, está diseñada para generar guiones y planos de producción de anuncios UGC (contenido generado por el usuario) realistas y creíbles creados por IA, a partir de una descripción de producto genérica. Se diferencia de una plantilla de remezcla porque no reproduce un anuncio existente, sino que aplica un conjunto de reglas narrativas y visuales para que el resultado parezca genuino, evitando los típicos errores de la IA (rostros perfectos, voces de estudio). La habilidad define invariantes técnicas clave, como el uso exclusivo de OpenRouter y ElevenLabs para la generación, y un 'portal de referencia' que exige una foto real para productos de marca conocida. Su estructura principal es una tabla de guion de rodaje con marcas de tiempo, diálogo, plano visual y gestos del creador, optimizada para formatos verticales de 15 segundos (TikTok, Reels, Shorts). El flujo de trabajo guía al agente paso a paso: desde la recopilación de datos del producto y el público objetivo, hasta la generación del creador sintético, la animación plano a plano, la postproducción de audio y música, y la renderización final. Es especialmente útil para desarrolladores y creadores que necesitan producir anuncios de aspecto humano y bajo costo para cualquier producto, sin necesidad de un actor real ni un estudio de grabación.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Disparador

SE ACTIVA ante una solicitud genérica de anuncio UGC: "haz un anuncio UGC para ", "creador reseñando mi ", "anuncio testimonial", "corto problema/solución para ", "antes/después para " (cuando el énfasis está en un creador que habla, no en un montaje puro del producto).

NO ACTIVAR cuando:

  • El usuario señala un anuncio específico para reproducir → ruta de remezcla (ralphy template use <slug>). Consulta docs/skills-vs-templates.md.
  • El usuario quiere cambiar solo el creador/persona en un clip existente → /ugc-model-swap.
  • La solicitud es para un anuncio de imagen estática, no un video → ese es un nicho diferente.

Qué es esta habilidad

Una superposición generalizada, no un anuncio terminado. Indica al pipeline CÓMO funcionan los anuncios UGC creíbles para que el guionista y el director de arte generen uno sólido para lo que sea que el usuario esté vendiendo. Se ejecuta a través del pipeline normal y nunca omite los portales de admisión, el portal de referencia obligatoria ni los portales de calidad.

Invariantes estrictas

  • Las invariantes del proveedor se mantienen. Toda la generación mediante ralphy generate (solo OpenRouter media + ElevenLabs — nada de FAL, Higgsfield, Canva ni API directa). Los renders mediante ralphy render <id>. Lee MODELS.md antes de nombrar cualquier ID de modelo.
  • Portal de referencia. Un producto de marca real conocido ("iPhone 16", "CeraVe cleanser") activa el portal de referencia obligatoria: recházalo sin una foto de referencia o un --no-ref-consent registrado. Un producto genérico/sin nombre procede sin referencia.
  • Los rostros de los creadores IA son personas sintéticas, no personas reales. Construye un creador inexistente coherente (consulta el flujo de trabajo). No mezcles rostros hacia una persona real reconocible.
  • La música es una pasada separada de ElevenLabs. Kling --audio es solo para la VO/lip-sync; prohíbe la música en el prompt de Kling y superpón una base instrumental en la etapa de edición (según la nota MEMORY.md de Kling sin música).

El nicho, en un párrafo

Un anuncio UGC vive o muere por la credibilidad y los primeros 3 segundos. El espectador debe sentir que una persona real le está hablando, no una marca. El gancho es un espejo del problema: muestra al espectador su propio problema para que deje de desplazarse porque se ve a sí mismo. Luego un compás de transformación/esperanza, luego un veredicto real, luego una CTA de baja fricción. La confianza proviene de los gestos (una risa nerviosa, un giro de cabello, contacto visual directo, señalar el producto) mucho más que de una entrega pulida. El mayor indicio de IA es un creador demasiado perfecto, demasiado simétrico y una voz de estudio limpia: lucha contra ambos.

Estructura del guion (predeterminado ~15s, 9:16)

Redacta un guion de rodaje como una tabla que el director de arte pueda desplegar:

Marca de tiempoVoz en off (palabras exactas)Visual / planoAcción / gesto
0-3sla línea del ganchoproblema mostrado visualmente, creador a cámaragesto de interrupción de patrón
3-7sel giroproducto aplicado / usado / demostradomanos en el producto
7-12sel veredictoreacción / antes-despuésreacción genuina (risa, cejas levantadas)
12-15sla CTAcreador a cámaraseñalar / "link in bio"

Principios de viralidad a integrar: gancho de espejo del problema, bucle de esperanza (transformación después del problema), interrupción de patrón de audio (un efecto de sonido "whoosh" en el corte), gestos = confianza, presencia de sala (un toque de reverberación en la VO para que suene grabada en una habitación, no en estudio), urgencia en la CTA (específica, de baja fricción).

Encuadre + realismo

  • Sensación de smartphone UGC sostenido en mano, a la altura de los ojos, 9:16. Luz natural interior, sin flash de teléfono plano.
  • Creador fotorrealista. Poros de la piel, microdetalle, ligera asimetría: pliega el registro anti-AI-slop / fotorrealista-estático (ralphy guideline list; consulta las notas MEMORY.md anti-ai-slop + photoreal-still). Un rostro impecable es la señal de alarma.
  • Genera la imagen de anclaje del creador con el producto en la mano o cerca del rostro para la referencia del primer fotograma.

Pila de modelos predeterminada (verificar contra MODELS.md)

  • Guion: el LLM guionista (callLLM) — aliméntalo con el máximo contexto (producto, problemas del público objetivo, patrones virales del nicho, el marco de gancho elegido).
  • Fotogramas clave del creador + producto: google/gemini-3-pro-image-preview (nano-banana-pro). Genera de 3 a 5 variantes, elige la más realista.
  • i2v (creador parlante multi-toma): kwaivgi/kling-v3.0-pro — dirígelo toma por toma (cada corte = creador habla → primer plano del producto → reacción → CTA). Kling --audio lleva la VO en EN + lip-sync; para idiomas distintos al EN, VO mediante ElevenLabs (confirma el idioma de destino en la admisión — consulta la nota MEMORY.md Kling-no-RU-audio).
  • Música: pasada separada de ElevenLabs Music, instrumental, mezclada en postproducción en el editor (sin nombres de artistas — MEMORY.md).
  • Subtítulos: por ranura sobre la VO bloqueada.

Flujo de trabajo

  1. Admisión. Recopila: producto (nombre / URL / imagen), público objetivo + sus problemas, tipo de gancho (problema-solución / antes-después / testimonial / transformación — o deja que el agente elija), idioma de destino, "no" rotundos. Anuncia: "Esto es un anuncio UGC — usando la habilidad de anuncio UGC." Valores predeterminados: 9:16, ~15s.
  2. Portal de referencia. Producto de marca real conocido → obtén una referencia o un --no-ref-consent registrado. Sin nombre → procede.
  3. Guion. Produce la tabla del guion de rodaje con marcas de tiempo; obtén el "adelante" del usuario.
  4. Anclaje de la persona del creador (con el producto), luego anclajes por compás — un compás a la vez con puntos de control.
  5. i2v por compás (Kling, lista de tomas dirigida), luego VO/SFX, luego post-mezcla de música, luego subtítulos, luego ralphy render <id>.
  6. Entrega a /evaluator para el portal de calidad posterior al render.

Recetario

  • "Haz un anuncio UGC para mi suero de vitamina C sin nombre" → sin referencia necesaria; gancho de espejo del problema (piel apagada), persona del creador, ~15s 9:16. Coincide con esta habilidad, ejecuta el pipeline.
  • "Anuncio de creador para el Dyson Airwrap" → producto real conocido → se activa el portal de referencia; pide primero una foto de referencia.
  • "El mismo anuncio pero con un creador diferente" → NO es esta habilidad → /ugc-model-swap.

Ver también

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.

Skills relacionados