Agent skill

Ugc Ad

by alecs5am in 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.

Apache-2.0Auto-check passedMarketing & SEO

Install Ugc Ad

skills CLI
$ npx skills add alecs5am/ralphy --skill ugc-ad -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install alecs5am/ralphy ugc-ad --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/alecs5am/ralphy.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/ugc-ad .claude/skills/ugc-ad && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
ugc-ad
GitHub stars
138
Token cost
~1.8k tokens
SKILL.md length
815 words
Files
1
Skills in repo
28
Repo updated
First seen
Licence
Apache-2.0

At a glance

How to make a realistic AI UGC ad for a product — generalized niche know-how that looks real and doesn't feel AI.

  • Works in 6 steps: Intake. Collect: product (name / URL /… → Reference gate. Named real brand product… → Script. Produce the timestamped… → …
  • 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
  • SKILL.md covers Trigger, What this skill is, Hard invariants and The niche, in one paragraph, plus 6 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Ugc Ad is an agent skill from 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…

Its SKILL.md is about 1.8k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Marketing & SEO, covering Influencer and creator marketing. It works with TikTok. The repository describes itself as: Open-source desktop app for content creation, with an agent runtime and standalone CLI. The licence is Apache-2.0.

When your agent uses it

  • 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
  • Problem-solution short for TikTok / Reels / Shorts
  • With no specific existing video to reproduce

Example prompts

  • “make an ad that looks like a real person reviewing my product”
  • “remix this exact ad but swap the product/person”
  • “/ugc-ad”

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. Intake. Collect: product (name / URL / image), target audience + their pain, hook type (problem-solution / before-after / testimonial /…
  2. Reference gate. Named real brand product → get a ref or logged --no-ref-consent. No-name → proceed.
  3. Script. Produce the timestamped shooting-script table; get the user's "go".
  4. Creator persona anchor (with product), then per-beat anchors — one beat at a time with checkpoints.
  5. i2v per beat (Kling, directed shot list), then VO/SFX, then music post-mix, then captions, then ralphy render .
  6. Hand off to /evaluator for the post-render quality gate.

What it can do on your machine

Read from SKILL.md and the folder at commit 8d139f0. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Ugc Ad loads about 1.8k tokens when it runs. Until then it costs about 248 tokens; SKILL.md has 815 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~248
When it runs · the whole SKILL.md, loaded when a task matches
~1.8k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from alecs5am/ralphy at commit 8d139f0, republished under its Apache-2.0 licence (© alecs5am). 815 words, ~1,773 tokens.

Download SKILL.mdSave it as .claude/skills/ugc-ad/SKILL.md (or your agent's skills folder).
name
ugc-ad
description
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.
namespace
user

Trigger

FIRES on a generic UGC-ad brief: "make a UGC ad for <product>", "creator reviewing my <product>", "testimonial ad", "problem/solution short for <app>", "before/after for <product>" (when the emphasis is a talking creator, not a pure product montage).

DO NOT FIRE when:

  • The user points at one specific ad to reproduce → remix path (ralphy template use <slug>). See docs/skills-vs-templates.md.
  • The user wants to swap only the creator/person in an existing clip → /ugc-model-swap.
  • The brief is a static image ad, not video → that is a different niche.

What this skill is

A generalized overlay, not a finished ad. It tells the pipeline HOW believable UGC ads work so the scenarist and art-director produce a strong one for whatever the user is selling. It runs through the normal pipeline and never bypasses the intake gates, the reference-required gate, or the quality gates.

Hard invariants

  • Provider invariants stand. All generation via ralphy generate (OpenRouter media + ElevenLabs only — no FAL, no Higgsfield, no Canva, no raw API). Renders via ralphy render <id>. Read MODELS.md before naming any model id.
  • Reference gate. A named real brand product ("iPhone 16", "CeraVe cleanser") fires the reference-required gate — refuse without a ref photo or logged --no-ref-consent. A no-name / generic product proceeds without a ref.
  • AI-creator faces are synthetic personas, not real people. Build a consistent non-existent creator (see workflow). Do not face-mix toward a recognizable real person.
  • Music is a separate ElevenLabs pass. Kling --audio is for the VO/lipsync only; ban music in the Kling prompt and overlay an instrumental bed in the editor stage (per MEMORY.md Kling-no-music note).

The niche, in one paragraph

A UGC ad lives or dies on believability and the first 3 seconds. The viewer must feel a real person is talking to them, not a brand. The hook is a problem mirror — show the viewer their own problem so they stop scrolling because they see themselves. Then a transformation/hope beat, then a real verdict, then a low-friction CTA. Trust comes from mannerisms (a nervous laugh, a hair tuck, direct eye contact, pointing at the product) far more than from polished delivery. The single biggest AI tell is a too-perfect, too-symmetrical creator and a studio-clean voice — fight both.

Beat / script shape (default ~15s, 9:16)

Author a shooting script as a table the art-director can fan out from:

TimestampVoiceover (exact words)Visual / shotAction / mannerism
0-3sthe hook lineproblem shown visually, creator to camerapattern-interrupt gesture
3-7sthe turnproduct applied / used / demoedhands on product
7-12sthe verdictreaction / before-aftergenuine reaction (laugh, raised brows)
12-15sthe CTAcreator to camerapoint / "link in bio"

Virality principles to bake in: problem-mirror hook, hope loop (transformation after the problem), audio pattern-interrupt (a whoosh SFX on the cut), mannerisms = trust, room presence (a touch of reverb on the VO so it reads recorded-in-a-room, not studio), CTA urgency (specific, low-friction).

Show full SKILL.md (340 more words)Show less

Framing + realism

  • Handheld smartphone-UGC feel, eye-level, 9:16. Natural indoor light, not flat phone-flash.
  • Photoreal creator. Skin pores, micro-detail, slight asymmetry — fold the anti-AI-slop / photoreal-still register in (ralphy guideline list; see MEMORY.md anti-ai-slop + photoreal-still notes). A flawless face is the giveaway.
  • Generate the creator anchor with the product in hand or near the face for the first-frame reference.

Default model stack (verify against MODELS.md)

  • Script: the scenarist LLM (callLLM) — feed it max context (product, target pains, the niche's viral patterns, the chosen hook framework).
  • Creator + product keyframes: google/gemini-3-pro-image-preview (nano-banana-pro). Generate 3-5 variants, pick the most realistic.
  • i2v (multi-shot talking creator): kwaivgi/kling-v3.0-pro — direct it shot-by-shot (each cut = creator speaks → product close-up → reaction → CTA). Kling --audio carries the EN VO + lipsync; for non-EN, VO via ElevenLabs (confirm target language at intake — see MEMORY.md Kling-no-RU-audio).
  • Music: separate ElevenLabs Music pass, instrumental, post-mixed in the editor (no artist names — MEMORY.md).
  • Captions: per-slot on the locked VO.

Workflow

  1. Intake. Collect: product (name / URL / image), target audience + their pain, hook type (problem-solution / before-after / testimonial / transformation — or let the agent pick), target language, hard "no"s. Announce: "This is a UGC ad — using the UGC-ad skill." Defaults: 9:16, ~15s.
  2. Reference gate. Named real brand product → get a ref or logged --no-ref-consent. No-name → proceed.
  3. Script. Produce the timestamped shooting-script table; get the user's "go".
  4. Creator persona anchor (with product), then per-beat anchors — one beat at a time with checkpoints.
  5. i2v per beat (Kling, directed shot list), then VO/SFX, then music post-mix, then captions, then ralphy render <id>.
  6. Hand off to /evaluator for the post-render quality gate.

Cookbook

  • "Make a UGC ad for my no-name vitamin-C serum" → no ref needed; problem-mirror hook (dull skin), creator persona, ~15s 9:16. Match this skill, run the pipeline.
  • "Creator ad for the Dyson Airwrap" → named real product → reference gate fires; ask for a ref photo first.
  • "Same ad but with a different creator" → NOT this skill → /ugc-model-swap.

See also

© alecs5am, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .agents/skills/ugc-ad of alecs5am/ralphy.

Open the folder on GitHubat commit 8d139f0

Compare with similar skills

Ugc Ad next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Ugc Ad compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Ugc Ad this skillalecs5am/ralphy138—~1.8kAutomated safety check: PassApache-2.0
Reelclaw Adsdansugc/reelclaw145—~3.9kAutomated safety check: NotesMIT
Higgsfield Content FactoryDaanKieft/ai-influencer116—~15kAutomated safety check: PassNone
Scenario Ugcscenario-labs/skills946—~3.1kAutomated safety check: PassMIT
Audience ResearchScrapeCreators/social-media-research-skills3.4k—~635Automated safety check: NotesMIT
Influencer Discoverytigerless-labs/influencer-discovery212—~2.5kAutomated safety check: NotesNone

Similar skills

  • Reelclaw Ads

    dansugc/reelclaw

    Make short-form UGC video ads (TikTok, Reels, Shorts) for the product in the current repo with DansUGC ReelClaw and real human creator reactions from the DansUGC library.

    145 GitHub stars~3.9k tokensUpdated 12 days ago
    Marketing & SEOAuto-check: notes
  • Higgsfield Content Factory

    DaanKieft/ai-influencer

    A 5-stage AI content pipeline using Higgsfield MCP, focused on viral UGC content split evenly across 5 formats: UGC Entertainment (challenges), Street Interview, Unboxing, Product Review, ASMR.

    116 GitHub stars~15k tokensUpdated 4 mo ago
    Marketing & SEOAuto-check passed
  • Scenario Ugc

    scenario-labs/skills

    A skill your agent uses when producing UGC-style creator video with Scenario: a talking-head ad or testimonial from a portrait and a script, a founder clip, a product demo or unboxing, a reaction or…

    946 GitHub stars~3.1k tokensUpdated yesterday
    Marketing & SEOAuto-check passed
  • Audience Research

    ScrapeCreators/social-media-research-skills

    A skill your agent uses when the user wants to evaluate a creator, influencer, or brand audience using public profile signals, TikTok audience demographics, follower/following data, comments…

    3.4k GitHub stars~635 tokensUpdated 1 mo ago
    Marketing & SEOAuto-check: notes
  • Influencer Discovery

    tigerless-labs/influencer-discovery

    Find the bloggers/creators who can help promote your work, capture their contact info, and append them to the target sheet in Google Sheets.

    212 GitHub stars~2.5k tokensUpdated 18 days ago
    Marketing & SEOAuto-check: notes
  • Gingiris Ugc Matrix

    Gingiris-1031/Competitor-analysis-tool

    🇺🇸 UGC Matrix Growth Playbook — Scale user-generated content with AI + real creators.

    110 GitHub stars~790 tokensUpdated 2 days ago
    Marketing & SEOAuto-check passed

More from alecs5am/ralphy

All 28 skills in this repo
  • Gsap

    alecs5am/ralphy

    GSAP animation reference for HyperFrames. An agent skill from alecs5am/ralphy.

    138 GitHub stars~2.4k tokensUpdated 18 days ago
    Auto-check passed
  • Researcher

    alecs5am/ralphy

    Deep-research workflow for UGC reference material — turns one or more URLs / handles / trend queries into a single cited research report (report.md + sources.json) that a scenarist or art-director…

    138 GitHub stars~1.9k tokensUpdated 18 days ago
    Auto-check passed
  • Editor

    alecs5am/ralphy

    Composition and render craft — assembles scenario.json plus asset-manifest.json into a HyperFrames HTML composition and renders the mp4.

    138 GitHub stars~3.6k tokensUpdated 18 days ago
    Auto-check passed
  • Evaluator

    alecs5am/ralphy

    Quality evaluation of rendered UGC mp4s — scene segmentation, audio loudness / dead-air, caption density, and per-scene visual analysis.

    138 GitHub stars~3.6k tokensUpdated 18 days ago
    Auto-check passed
  • Producer

    alecs5am/ralphy

    End-to-end orchestration — the wrapper that drives the whole production contract across roles, plus batch production.

    138 GitHub stars~4.7k tokensUpdated 18 days ago
    Auto-check passed
  • Scenarist

    alecs5am/ralphy

    Scenario and script craft — writes and reworks the scene-by-scene scenario.json: hook, beat structure, per-scene VO, on-screen text, pacing, and the language/aspect pre-flight.

    138 GitHub stars~3.2k tokensUpdated 18 days ago
    Auto-check passed

Works with

Questions about Ugc Ad

What does Ugc Ad do?

How to make a realistic AI UGC ad for a product — generalized niche know-how that looks real and doesn't feel AI. Ugc Ad is an agent skill from 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.

When should I use Ugc Ad?

Ugc Ad fits situations like: 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; problem-solution short for TikTok / Reels / Shorts; with no specific existing video to reproduce.

How do I install Ugc Ad in Claude Code?

Run `npx skills add alecs5am/ralphy --skill ugc-ad -a claude-code`. Or copy the skill folder (.agents/skills/ugc-ad in alecs5am/ralphy) into .claude/skills/ugc-ad in your project. Claude Code loads it when a task matches its description.

How do I install Ugc Ad in Codex?

Run `npx skills add alecs5am/ralphy --skill ugc-ad -a codex`. Or copy the skill folder (.agents/skills/ugc-ad in alecs5am/ralphy) into .agents/skills/ugc-ad in your project. Codex loads it when a task matches its description.

Can I use Ugc Ad in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add alecs5am/ralphy --skill ugc-ad -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/ugc-ad, .gemini/skills/ugc-ad, .github/skills/ugc-ad and .opencode/skills/ugc-ad in your project.

What does Ugc Ad need to run?

SKILL.md names no scripts, command-line tools or credentials: Ugc Ad is instructions for the agent only.

Does Ugc Ad access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Ugc Ad safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Ugc Ad use?

Ugc Ad is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Ugc Ad use?

About 1.8k tokens (SKILL.md is roughly 7.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Ugc Ad?

Skills that share tags, products or a category with Ugc Ad: Reelclaw Ads (dansugc/reelclaw, 145 stars), Higgsfield Content Factory (DaanKieft/ai-influencer, 116 stars), Scenario Ugc (scenario-labs/skills, 946 stars) and Audience Research (ScrapeCreators/social-media-research-skills, 3.4k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Ugc Ad?

alecs5am (a GitHub user) maintains it in alecs5am/ralphy, which has 138 GitHub stars. The repository holds 28 skills in this directory. The repository was last updated on September 22, 2026.

Source: alecs5am/ralphy on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.