Communitygithub.com

alecs5am/ralphy

Kompletter End-to-End-Workflow zur Erstellung einer realistischen KI-UGC-Werbung für ein Produkt. 15-Sekunden-Format. Sieht echt aus. Fühlt sich nicht nach KI an.

Was ist ralphy?

Diese Fertigkeit beschreibt einen vollständig automatisierten Workflow zur Produktion von nutzergenerierten Werbeinhalten (UGC) mithilfe mehrerer KI-Tools. Sie ist speziell auf 15-sekündige vertikale Videos im 9:16-Format zugeschnitten, die wie echte, von Menschen erstellte Inhalte wirken. Der Prozess beginnt mit der Erstellung eines detaillierten Drehbuchs durch Claude Sonnet 4.6, das auf einem Referenz-UGC-Video und Produktinformationen basiert. Anschließend wird mit Nano Banana Pro ein realistisches, nicht existierendes Creator-Gesicht in 4K-Auflösung generiert. Das eigentliche Video wird mit Kling 3.0 erstellt, einem Multi-Shot-Modell, das Szenenwechsel und Creator-Manierismen versteht. Abschließend werden Sprachaufnahmen, Soundeffekte und der Schnitt in Canva hinzugefügt. Die Fertigkeit betont die Bedeutung von Viralitätsprinzipien wie Hooks, Vorher/Nachher-Darstellungen und authentischen Manierismen, um KI-generierte Inhalte von typischen, künstlich wirkenden Anzeigen zu unterscheiden. Sie unterstützt Plattformen wie Higgsfield, Fal.ai und die offizielle Kling-Website und bietet Kostenübersichten und Gutscheincodes für Testzwecke.

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

UGC-Anzeigen-Produktions-Pipeline

Erforderliche Eingaben (den Benutzer VOR dem Start nach ALLEN fragen)

Vor der Generierung sammeln:

  • Produkt – was wird beworben (Name, URL oder Bild)
  • Referenz-UGC-Video – ein echtes UGC-Video in derselben Nische/im selben Stil (Pinterest, TikTok, YouTube-Link). Dient als Vorlage für Skript-Stil, Creator-Persönlichkeit und Shot-Referenz.
  • Creator-Gesichtsreferenzen – 2+ Bilder von echten Personen (attraktiv, passend zur Marken-Vibe). Diese werden in Nano Banana Pro per Face-Mixing zu einem neuen, nicht existierenden Creator kombiniert.
  • Zielgruppe – für wen die Anzeige ist (z.B. Frauen 18-35 mit zu Akne neigender Haut)
  • Hook-Typ – Problem/Lösung, Vorher/Nachher, Testimonial, Transformation oder der Agent entscheidet basierend auf dem Produkt
  • NIEMALS fragen:
    • Welches Bearbeitungstool (immer Canva)
    • Videolänge (immer 15 Sekunden)
    • Seitenverhältnis (immer 9:16 vertikal)
    • Welches Videomodell (immer Kling 3.0)
    • Welches Bildmodell (immer Nano Banana Pro)

Schritt 1 – Drehbuch schreiben (Claude 4.6)

Tool: Claude claude-sonnet-4-6 (starkes Reasoning + kreatives Schreiben – so viel Kontext wie möglich füttern)

Prompt-Vorlage:

Erstelle ein UGC-Skript für ein 15-Sekunden-Video wie [REFERENZVIDEO] aber für [PRODUKT]. Verwende [CREATOR-BESCHREIBUNG aus Gesichtsreferenzen] als UGC-Creator/Sprecher. Enthalten:

  • Hook (erste 3-5 Sekunden): Zeige das Problem visuell + Audio-Hook
  • Voiceover-Zeilen mit genauen Worten
  • Schnittbeschreibungen: Was die Kamera zu jedem Zeitpunkt zeigt (Creator-Gesicht, Produkt, Vorher/Nachher, etc.)
  • Aktionen und Manierismen: Den Creator wie eine echte Figur wirken lassen – nervöses Lachen, Haarsträhne zurückstecken, direkter Blickkontakt, auf Produkt zeigen, etc.
  • Call-to-Action (letzte 2-3 Sekunden)
  • Zeitstempel für jeden Schnitt/jede Aktion Ausgabe als Drehbuch-Tabelle mit Spalten: Zeitstempel | Voiceover | Bild/Shot | Aktion/Manierismus

Hinweise:

  • Claude maximalen Kontext geben: die Referenzvideo-URL, Produktdetails, Schmerzpunkte der Zielgruppe, andere virale UGC-Videos in der Nische, Storytelling-Frameworks (Problem-Aufregen-Lösen, Vorher/Nachher, etc.)
  • Je mehr Kontext, desto besser das Skript. Claudes Reasoning-Fähigkeit ist hier der Vorteil.
  • Viralitätsprinzipien, die eingebaut werden sollen: Pattern-Interrupt-Hook, Social Proof, Transformationsmoment, Dringlichkeits-CTA
  • Ausgabe: Ein mit Zeitstempeln versehenes Drehbuch mit Voiceover, Bildern und Creator-Manierismen.

Schritt 2 – Creator-Gesicht generieren (Nano Banana Pro)

Tool: Nano Banana Pro (4K – erforderlich für realistische Hauttextur, Poren, Details)

Prompt-Vorlage:

Mische diese beiden Gesichter, um ein neues attraktives Gesicht zu erschaffen, das keiner realen Person gehört. Verwende das Ergebnis als Gesicht eines UGC-Beauty-/Lifestyle-Content-Creators. Generiere in 4K-Auflösung. Hyperrealistische Hauttextur, natürliche Beleuchtung, Creator hält ein Ringlicht-Mikrofon.

Hinweise:

  • 2+ Pinterest/Stock-Gesichtsreferenzen verwenden, die zur Markenpersönlichkeit passen (relatierbar, aspirativ, nischengerecht)
  • Mit Produkt in der Hand oder nahe am Gesicht für die Erstbild-Referenz generieren
  • Hautporen, Mikro-Details, natürliche Unvollkommenheiten erwünscht – das lässt es nicht nach KI aussehen
  • Plattform-Optionen (günstigste bis beste):
    • Higgsfield (Creator-Plan) – Freemium, funktioniert
    • Fal.ai – Gutschein pixelriot20hackathon-fal für $20 Gratisguthaben verwenden
    • Google AI Studio – kostenpflichtig, meiste Kontrolle
  • 3-5 Varianten generieren, die realistischste auswählen
  • Ausgabe: Ein 4K-Porträtbild des KI-Creators, der das Produkt hält.

Schritt 3 – Video generieren (Kling 3.0)

Tool: Kling 3.0 (15-Sekunden-Multi-Shot-Modell)

Warum Kling 3.0:

  • 15-Sekunden-native Ausgabelänge
  • Multi-Shot: kann zwischen Creator-Sprache → Produkt-Nahaufnahme → Haut-Transformation → zurück zum Creator schneiden
  • Expressiv: versteht Creator-Manierismen, Gesten, Persönlichkeit
  • Hat kontextuelles Verständnis von Content-Plattformen (UGC-nativ)

Setup:

  • Eingabe: Creator-Bild (Schritt 2) als Startbild
  • Eingabe: Produktbild als Referenzbild (nicht unbedingt Startbild – kann Mid-Video-Referenz sein)
  • Eingabe: Drehbuch (Schritt 1) als Bewegungs-/Shot-Prompt

Prompt-Struktur:

[Erstes Bild: Creator hält Produkt, schaut in Kamera, natürliche Beleuchtung] Schnitt 1 (0-3s): Creator spricht direkt in Kamera mit [Manierismus], sagt „[Hook-Zeile]“ Schnitt 2 (3-7s): Nahaufnahme des Produkts, das aufgetragen / auf der Haut verwendet wird Schnitt 3 (7-12s): Creator-Reaktionsshot – [Emotion/Manierismus aus Drehbuch] Schnitt 4 (12-15s): Creator blickt in Kamera, liefert CTA, [Manierismus]

Hinweise:

  • Shots kontrollieren = Kling genau sagen, was jeder Schnitt zeigt. Das ist nicht nur Promting – es ist Regie führen.
  • Multi-Shot = die Schnitte wie ein Regisseur beschreiben, nicht wie ein Prompter
  • Bei Unsicherheit: Vor dem Versuch ein Kling 3.0 Multi-Shot-Tutorial ansehen
  • Kosten: ~4-5 $ pro 15s-Clip. Kostenloses Testen: Fal.ai mit Gutschein pixelriot20hackathon-fal
  • Plattformen: Higgsfield, offizielle Kling-Website, Fal.ai
  • Ausgabe: Ein 15-Sekunden-Rohvideoclip.

Viralitätsprinzipien (In jeden Schritt einbauen)

  • Hook = Problem-Spiegel: Zeige dem Publikum in den ersten 3 Sekunden sein eigenes Problem. Sie hören auf zu scrollen, weil sie sich selbst sehen.
  • Vorher/Nachher = Hoffnungs-Loop: Nach dem Problem-Hook die Transformation zeigen. Das erzeugt Verlangen.
  • Audio-Hook: Der Whoosh-SFX am Schnitt ist ein Pattern-Interrupt – hält die Sehdauer hoch.
  • Creator-Manierismen = Vertrauen: Ein Creator, der sich wie eine echte Person anfühlt (nervös lacht, Haarsträhne zurücksteckt, seufzt), baut unterbewusst schneller Vertrauen auf als eine perfekte Darbietung.
  • Hall = Raumpräsenz: 10% Hall lässt die Stimme klingen, als wäre sie in einem echten Raum aufgenommen, nicht in einem Studio. Entfernt das „KI-Radiostimme“-Gefühl.
  • CTA-Dringlichkeit: Letzte 2-3 Sekunden. Direkt, spezifisch, niedrige Hemmschwelle („Link in Bio“, „Tipp auf den Link“, „Schreib mir eine DM“).

Marken-Hinweis

Falls dies für ein echtes Konto/eine echte Marke ist (nicht Test):

  • Das Creator-Gesicht sollte zur Zielgruppen-Persona der Marke passen
  • Der Stil/Die Vibe des Creators sollte in allen UGC-Videos konsistent sein

Ästhetiken nicht zwischen Videos mischen – eine auswählen und beibehalten.

Plattform-/Kostenzusammenfassung

ToolZweckKosten
Gemini 2.5 ProDrehbuch schreibenKostenlos (AI Studio)
Nano Banana ProCreator-Gesicht + ProduktbilderHiggsfield Creator-Plan / Fal.ai (20 $-Gutschein: pixelriot20hackathon-fal)
Kling 3.0Video-Generierung~4-5 $/Clip – Higgsfield / Kling AI / Fal.ai
ElevenLabsSprachklonen + AustauschKostenpflichtig (Sprachtrainings-Feature)
Play.htSprachklonen (Alternative)Freemium
CanvaVideobearbeitung + TextKostenlos / Pro
ArtlistSoundeffekteKostenpflichtig (kostenlose Alternativen verfügbar)

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

Verwandte Skills