Communitygithub.com

alecs5am/ralphy

Comment créer une pub UGC IA réaliste pour un produit — savoir-faire généralisé qui a l'air authentique sans donner l'impression d'être généré par IA. Superposition de domaine sur le pipeline standard : fournit la structure du script de tournage (timestamp | VO | plan | tic), la construction du persona créateur, l'accroche miroir du problème, la règle de confiance par les tics, et les paramètres par défaut du format UGC 9:16 ~15s. Fonctionne pour TOUT produit nommé par l'utilisateur — sa gamme de soins, une application inconnue, un gadget. La compétence fournit le savoir-faire ; l'utilisateur fournit le produit.

Qu'est-ce que ralphy ?

Ce skill fournit un modèle généralisé pour créer des publicités vidéo générées par IA au format UGC (contenu généré par l'utilisateur), conçues pour paraître authentiques et non générées par IA. Il s'active sur des demandes génériques comme « crée une pub UGC pour <produit> » ou « avis de créateur pour mon <produit> ». Le skill structure l'ensemble du processus : rédaction d'un script de tournage horodaté, construction d'un persona de créateur IA cohérent, application des principes de viralité (accroche miroir du problème, boucle d'espoir, tics de confiance) et respect des formats par défaut (9:16, ~15s). Il s'intègre au pipeline existant via des étapes de validation strictes (portail de référence, portail qualité) et utilise des modèles de génération spécifiques (Gemini pour les images clés, Kling pour la vidéo, ElevenLabs pour la voix ou la musique). Le skill distingue clairement la création d'une pub originale (son cas d'usage) du remix d'une pub existante ou du simple échange de créateur, renvoyant alors vers des outils dédiés. Il est conçu pour fonctionner avec n'importe quel produit, qu'il s'agisse d'une grande marque (nécessitant alors une photo de référence) ou d'un produit générique.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Déclencheur

SE DÉCLENCHE sur une demande générique de pub UGC : "crée une pub UGC pour ", "créateur donne son avis sur mon ", "pub témoignage", "court métrage problème/solution pour ", "avant/après pour " (quand l'accent est mis sur un créateur qui parle, pas sur un montage pur produit).

NE PAS DÉCLENCHER quand :

  • L'utilisateur pointe une pub spécifique à reproduire → chemin de remix (ralphy template use <slug>). Voir docs/skills-vs-templates.md.
  • L'utilisateur veut seulement changer le créateur/la personne dans un clip existant → /ugc-model-swap.
  • La demande est une pub image statique, pas une vidéo → c'est un domaine différent.

Ce qu'est cette compétence

Une superposition généralisée, pas une pub finie. Elle indique au pipeline COMMENT fonctionnent les pubs UGC crédibles, afin que le scénariste et le directeur artistique produisent une pub solide pour tout ce que l'utilisateur vend. Elle s'exécute via le pipeline normal et ne contourne jamais les portails d'admission, le portail d'exigence de référence ou les portails qualité.

Invariants stricts

  • Les invariants du fournisseur tiennent. Toute génération via ralphy generate (OpenRouter media + ElevenLabs uniquement — pas de FAL, pas de Higgsfield, pas de Canva, pas d'API brute). Rendu via ralphy render <id>. Lire MODELS.md avant de nommer un ID de modèle.
  • Portail de référence. Un produit de marque réelle nommé ("iPhone 16", "CeraVe cleanser") déclenche le portail d'exigence de référence — refuser sans photo de référence ou --no-ref-consent enregistré. Un produit sans nom / générique avance sans référence.
  • Les visages de créateurs IA sont des personnages synthétiques, pas de vraies personnes. Construire un créateur inexistant cohérent (voir le flux de travail). Ne pas faire de mixage de visages vers une personne réelle reconnaissable.
  • La musique est un passage ElevenLabs séparé. Kling --audio est réservé à la VO / synchronisation labiale ; interdire la musique dans le prompt Kling et superposer un fond instrumental dans l'étape de montage (selon la note MEMORY.md Kling-pas-de-musique).

Le créneau, en un paragraphe

Une pub UGC se joue sur la crédibilité et les 3 premières secondes. Le spectateur doit sentir qu'une vraie personne lui parle, pas une marque. L'accroche est un miroir du problème — montrer au spectateur son propre problème pour qu'il arrête de défiler parce qu'il se reconnaît. Puis un temps de transformation/espoir, puis un verdict sincère, puis un CTA à faible friction. La confiance vient des tics (un rire nerveux, un geste pour remettre une mèche, un regard direct, pointer le produit) bien plus que d'un discours parfait. Le plus grand indice d'IA est un créateur trop parfait, trop symétrique et une voix trop propre de studio — combattez les deux.

Structure du script (par défaut ~15s, 9:16)

Rédiger un script de tournage sous forme de tableau que le directeur artistique peut déployer :

TimestampVoix off (mots exacts)Visuel / planAction / tic
0-3sla ligne d'accrocheproblème montré visuellement, créateur face camérageste d'interruption de motif
3-7sle tournantproduit appliqué / utilisé / démontrémains sur le produit
7-12sle verdictréaction / avant-aprèsréaction authentique (rire, sourcils levés)
12-15sle CTAcréateur face camérapointer / "lien dans la bio"

Principes de viralité à intégrer : accroche miroir du problème, boucle d'espoir (transformation après le problème), interruption de motif audio (un effet sonore de souffle sur la coupure), les tics = confiance, présence de la pièce (un peu de réverbération sur la VO pour qu'elle sonne enregistrée dans une pièce, pas en studio), urgence du CTA (spécifique, à faible friction).

Cadrage + réalisme

  • Sensation smartphone-UGC tenu à la main, à hauteur des yeux, 9:16. Lumière naturelle intérieure, pas de flash téléphone plat.
  • Créateur photoréaliste. Pores de la peau, micro-détails, légère asymétrie — utiliser le registre anti-IA-moche / photoréaliste fixe (ralphy guideline list ; voir les notes MEMORY.md anti-IA-moche + photoréaliste fixe). Un visage parfait est l'indice révélateur.
  • Générer l'ancrage du créateur avec le produit en main ou près du visage pour la référence de la première image.

Pile de modèles par défaut (vérifier par rapport à MODELS.md)

  • Script : le LLM scénariste (callLLM) — lui fournir le maximum de contexte (produit, problèmes cibles, schémas viraux du créneau, cadre d'accroche choisi).
  • Images clés du créateur + produit : google/gemini-3-pro-image-preview (nano-banane-pro). Générer 3 à 5 variantes, choisir la plus réaliste.
  • i2v (créateur parlant multi-plans) : kwaivgi/kling-v3.0-pro — le diriger plan par plan (chaque coupe = créateur parle → gros plan produit → réaction → CTA). Kling --audio gère la VO EN + synchronisation labiale ; pour les langues autres que l'EN, VO via ElevenLabs (confirmer la langue cible à l'admission — voir note MEMORY.md Kling-pas-d'audio-RU).
  • Musique : passage ElevenLabs Music séparé, instrumental, mixé après en montage (pas de noms d'artistes — MEMORY.md).
  • Sous-titres : par plage sur la VO verrouillée.

Flux de travail

  1. Admission. Collecter : produit (nom / URL / image), audience cible + leurs problèmes, type d'accroche (problème-solution / avant-après / témoignage / transformation — ou laisser l'agent choisir), langue cible, les "non" stricts. Annoncer : "Ceci est une pub UGC — utilisation de la compétence pub UGC." Valeurs par défaut : 9:16, ~15s.
  2. Portail de référence. Produit de marque réelle nommé → obtenir une référence ou un --no-ref-consent enregistré. Produit sans nom → continuer.
  3. Script. Produire le tableau du script de tournage horodaté ; obtenir le "go" de l'utilisateur.
  4. Ancrage du persona créateur (avec produit), puis ancrages par temps — un temps à la fois avec points de contrôle.
  5. i2v par temps (Kling, liste de plans dirigée), puis VO/effets sonores, puis post-mixage musique, puis sous-titres, puis ralphy render <id>.
  6. Transmettre à /evaluator pour le portail qualité post-rendu.

Recettes

  • "Crée une pub UGC pour mon sérum à la vitamine C sans nom" → pas de référence nécessaire ; accroche miroir du problème (peau terne), persona créateur, ~15s 9:16. Correspond à cette compétence, exécuter le pipeline.
  • "Pub créateur pour le Dyson Airwrap" → produit de marque réelle nommé → portail de référence déclenché ; demander d'abord une photo de référence.
  • "Même pub mais avec un créateur différent" → PAS cette compétence → /ugc-model-swap.

Voir aussi

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 associés