Communitygithub.com

alecs5am/ralphy

Erstellen Sie realistische KI-gestützte UGC-Anzeigen für beliebige Produkte – mit authentischen Creator-Personas, problemspiegelndem Hook und vertrauensbildenden Manierismen. Dieses Skill liefert das Know-how, der Nutzer liefert das Produkt.

Was ist ralphy?

Das Skill 'ralphy' ist ein generalisiertes Overlay für die standardmäßige KI-Anzeigenpipeline, das speziell für die Erstellung realistischer User-Generated-Content (UGC)-Anzeigen entwickelt wurde. Es eignet sich für jede Art von Produkt – von Hautpflege über Apps bis hin zu Gadgets – und wird aktiviert, wenn ein Nutzer nach einer authentischen, Creator-basierten Werbung fragt, die wie eine echte Produktbewertung wirkt. Der Kern des Skills liegt in der Betonung von Glaubwürdigkeit und den ersten drei Sekunden: Ein Problemspiegel-Hook, eine Transformation und ein glaubwürdiges Urteil mit charakteristischen Manierismen wie nervösem Lachen oder direktem Blickkontakt erzeugen Vertrauen. Das Skill definiert ein striktes Arbeitsablaufmodell mit festen Anbietern (OpenRouter und ElevenLabs), einem Referenzgate für echte Markenprodukte und einer detaillierten Drehbuchstruktur als Tabelle. Es unterstützt die Formate 9:16 und ~15s Dauer für TikTok, Reels oder Shorts und arbeitet mit synthetischen Creator-Personas, die nie auf echte Personen zurückgreifen. Das Skill ist keine fertige Vorlage, sondern ein Leitfaden, der die Pipeline Schritt für Schritt steuert und Qualitätstests durchläuft.

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

In Ihrer bevorzugten KI fragen

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

Dokumentation

Auslöser

FEUERT bei einer generischen UGC-Anzeigen-Brief: "Erstelle eine UGC-Anzeige für ", "Creator bewertet mein ", "Testimonial-Anzeige", "Problem/Lösung-Short für ", "Vorher/Nachher für " (wenn der Fokus auf einem sprechenden Creator liegt, nicht auf einer reinen Produktmontage).

FEUERE NICHT wenn:

  • Der Nutzer auf eine bestimmte vorhandene Anzeige verweist → Remix-Pfad (ralphy template use <slug>). Siehe docs/skills-vs-templates.md.
  • Der Nutzer nur den Creator/die Person in einem bestehenden Clip austauschen möchte → /ugc-model-swap.
  • Die Anforderung ein statisches Bild ist, kein Video → das ist eine andere Nische.

Was dieses Skill ist

Ein generalisiertes Overlay, keine fertige Anzeige. Es erklärt der Pipeline WIE glaubwürdige UGC-Anzeigen funktionieren, damit der Szenarist und der Art Director eine starke Anzeige für das Produkt des Nutzers erstellen. Es durchläuft die normale Pipeline und umgeht niemals die Intake-Gates, das Referenz-Gate oder die Qualitäts-Gates.

Harte Invarianten

  • Provider-Invarianten bleiben bestehen. Sämtliche Generierung erfolgt über ralphy generate (OpenRouter Medien + ElevenLabs nur – kein FAL, kein Higgsfield, kein Canva, keine rohe API). Rendering über ralphy render <id>. Lies MODELS.md, bevor du eine Modell-ID nennst.
  • Referenz-Gate. Ein namentlich genanntes echtes Markenprodukt ("iPhone 16", "CeraVe Reinigungsmilch") löst das Referenz-Gate aus – verweigere die Ausführung ohne ein Referenzfoto oder ein protokolliertes --no-ref-consent. Ein namenloses/generisches Produkt kann ohne Referenz fortfahren.
  • KI-Creator-Gesichter sind synthetische Personas, keine echten Menschen. Erstelle eine konsistente nicht existierende Persona (siehe Workflow). Mische keine Gesichter in Richtung eines erkennbaren echten Menschen.
  • Musik ist ein separater ElevenLabs-Durchlauf. Kling --audio ist nur für die Sprachausgabe/Lipsync; verbiete Musik im Kling-Prompt und lege im Editorstadium eine instrumentale Untermalung darüber (gemäß MEMORY.md Hinweis zu Kling-keine-Musik).

Die Nische in einem Absatz

Eine UGC-Anzeige steht und fällt mit Glaubwürdigkeit und den ersten 3 Sekunden. Der Zuschauer muss das Gefühl haben, dass eine echte Person mit ihm spricht, nicht eine Marke. Der Hook ist ein Problemspiegel – zeige dem Zuschauer sein eigenes Problem, damit er aufhört zu scrollen, weil er sich selbst sieht. Dann ein Transformations-/Hoffnungsbeat, dann ein echtes Urteil, dann ein reibungsarmer CTA. Vertrauen entsteht durch Manierismen (ein nervöses Lachen, eine Haarsträhne, direkter Blickkontakt, Zeigen auf das Produkt) weit mehr als durch eine polierte Performance. Der mit Abstand größte KI-Verrat ist ein zu perfekter, zu symmetrischer Creator und eine Studio-überreine Stimme – bekämpfe beides.

Beat-/Skript-Form (Standard ~15s, 9:16)

Erstelle ein Drehbuch als Tabelle, die der Art Director ausrollen kann:

ZeitstempelVoiceover (genaue Worte)Bild / EinstellungAktion / Manierismus
0-3sdie Hook-ZeileProblem visuell gezeigt, Creator zur KameraMuster-unterbrechende Geste
3-7sdie WendungProdukt angewendet/verwendet/vorgeführtHände am Produkt
7-12sdas UrteilReaktion / Vorher-Nachherechte Reaktion (Lachen, hochgezogene Augenbrauen)
12-15sder CTACreator zur KameraZeigen / "Link in Bio"

Viralitätsprinzipien, die eingebaut werden müssen: Problemspiegel-Hook, Hoffnungsschleife (Transformation nach dem Problem), Audio-Muster-Unterbrechung (ein Whoosh-SFX beim Schnitt), Manierismen = Vertrauen, Raumpräsenz (ein Hauch von Hall auf der Sprachausgabe, sodass sie sich wie in einem Raum aufgenommen anfühlt, nicht wie im Studio), CTA-Dringlichkeit (spezifisch, reibungsarm).

Bildgestaltung + Realismus

  • Handy-UGC-Handgefühl, Augenhöhe, 9:16. Natürliches Innenlicht, kein flacher Telefonblitz.
  • Fotorealistischer Creator. Hautporen, Mikrodetails, leichte Asymmetrie – berücksichtige das Anti-KI-Schrott/fotorealistisch-Standbild-Register (ralphy guideline list; siehe MEMORY.md Notizen zu Anti-KI-Schrott + fotorealistisch-Standbild). Ein makelloses Gesicht ist der Verräter.
  • Generiere den Creator-Anker mit dem Produkt in der Hand oder nahe am Gesicht für den Erstbild-Referenzrahmen.

Standard-Modell-Stapel (gegen MODELS.md prüfen)

  • Skript: der Szenarist-LLM (callLLM) – füttere ihn mit maximalem Kontext (Produkt, Ziel-Schmerzpunkte, virale Muster der Nische, gewähltes Hook-Framework).
  • Creator + Produkt-Keyframes: google/gemini-3-pro-image-preview (nano-banana-pro). Generiere 3-5 Varianten, wähle die realistischste.
  • i2v (mehrere Einstellungen, sprechender Creator): kwaivgi/kling-v3.0-pro – führe es Einstellung für Einstellung (jeder Schnitt = Creator spricht → Produkt-Nahaufnahme → Reaktion → CTA). Kling --audio trägt die EN-Sprachausgabe + Lipsync; für Nicht-EN: Sprachausgabe über ElevenLabs (Zielsprache beim Intake bestätigen – siehe MEMORY.md Kling-keine-RU-Audio).
  • Musik: separater ElevenLabs Music-Durchlauf, instrumental, im Editor nachbearbeitet (keine Künstlernamen – MEMORY.md).
  • Untertitel: pro Slot auf der finalen Sprachausgabe.

Workflow

  1. Intake. Sammle: Produkt (Name / URL / Bild), Zielgruppe + deren Schmerzpunkte, Hook-Typ (Problem-Lösung / Vorher-Nachher / Testimonial / Transformation – oder lass den Agenten wählen), Zielsprache, harte "Nein"s. Verkünde: "Dies ist eine UGC-Anzeige – mit dem UGC-Anzeigen-Skill." Standardeinstellungen: 9:16, ~15s.
  2. Referenz-Gate. Namentlich genanntes echtes Markenprodukt → hole ein Referenzfoto oder ein protokolliertes --no-ref-consent. Namenlos → fortfahren.
  3. Skript. Erstelle die Tabelle mit Zeitstempeln; hole das "Los" des Nutzers.
  4. Creator-Persona-Anker (mit Produkt), dann Anker pro Beat – ein Beat nach dem anderen mit Checkpoints.
  5. i2v pro Beat (Kling, geführte Einstellungsliste), dann Sprachausgabe/SFX, dann Musik nachbearbeitet, dann Untertitel, dann ralphy render <id>.
  6. Übergabe an /evaluator für das Qualitäts-Gate nach dem Rendern.

Kochbuch

  • "Erstelle eine UGC-Anzeige für mein namenloses Vitamin-C-Serum" → kein Referenzfoto nötig; Problemspiegel-Hook (stumpfe Haut), Creator-Persona, ~15s 9:16. Entspricht diesem Skill, führe die Pipeline aus.
  • "Creator-Anzeige für den Dyson Airwrap" → namentlich genanntes echtes Produkt → Referenz-Gate feuert; bitte zuerst um ein Referenzfoto.
  • "Gleiche Anzeige, aber mit einem anderen Creator" → NICHT dieses Skill → /ugc-model-swap.

Siehe auch

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.

Verwandte Skills