muapi-ugc-ads-workflow

Q: How do I install muapi-ugc-ads-workflow?

Run npx skills add https://github.com/samuraigpt/generative-media-skills --skill muapi-ugc-ads-workflow in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/muapi-ugc-ads-workflow/ (personal) or .claude/skills/muapi-ugc-ads-workflow/ (project).

by samuraigptMarketing & SEO

Create a User-Generated Content (UGC) video ad by combining a human selfie and a product image, then generating a video script and an animated ad.

Installs: 663
Last 24h: —
Trending rank: —
Security: Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/samuraigpt/generative-media-skills --skill muapi-ugc-ads-workflow

01
Install
Run the command in your project. The CLI asks which agents to install for.
02
Describe the task
Ask your agent for something this skill covers. It loads muapi-ugc-ads-workflow automatically when relevant.
03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

UGC Ads Workflow

Create a User-Generated Content (UGC) video ad by combining a human selfie and a product image, then generating a video script and an animated ad.

Inputs

Name	Type	Required	Default	Description
`product_name`	text	yes	—	The name of the product being advertised (e.g. "Blume SuperBalm in plum").
`human_image`	image_url	no	—	A selfie or photo of the human influencer.
`product_image`	image_url	no	—	A clear photo of the product.

Steps

Phase A — Image Combination

If {{human_image}} or {{product_image}} is not provided, ask the user to upload them or offer to generate them.

Once both images are available, submit the plan with ONE step to combine them:

Image Generation — muapi image edit (model=gpt-image-2-text-to-image):
- Reference Images: Use both {{human_image}} and {{product_image}}.
- Prompt: A natural, candid UGC-style photo of the influencer from the first reference image holding and showcasing the product from the second reference image. The influencer is smiling genuinely at the camera, holding the product up. Natural indoor lighting, lifestyle aesthetic, high quality.
- Aspect ratio: 9:16 (vertical for TikTok/Reels/Shorts).

Present the combined image to the user for approval.

Phase B — Script & Video Generation

Research & Scripting: Use your web search tools to find details about {{product_name}} to understand its key benefits.
Based on the research, craft a UGC-style video script with timestamps, similar to this format:

(0-2s) Influencer is holding the {{product_name}}, smiling genuinely to the camera. "Okay, so you know how I'm always looking for that perfect everyday product?" (2-7s) Influencer shows the product closer to the camera... "Well, I found it! This {{product_name}} is seriously so good." (7-12s) Influencer uses/applies the product. "It feels amazing and actually works." (12-15s) Influencer smiles, slightly pouts, and casually shrugs or nods in approval. "It’s totally become my go-to. You have to try it!"
Video Generation: Submit the plan using an image-to-video model (e.g. sd-2-omni-reference or veo3.1-image-to-video).
- Reference Image: The combined image from Phase A.
- Prompt: Use the visual actions from the script you generated. For example: A UGC-style video. The influencer holds the {{product_name}}, smiling genuinely. She brings it closer to the camera to show the label, then applies it smoothly. She nods in approval and smiles. Natural movements, talking to the camera, lifestyle vlog style.
- Aspect ratio: 9:16

After generating the video, present it along with the written script so the user can record their own voiceover or use a lipsync tool later.

Trigger Keywords

ugc ad, ugc video, influencer ad, product ad video, combine product and human

Notes for the Executing Agent

This recipe is LLM-orchestrated: read each phase, gather any missing inputs from the user, then call muapi CLI commands. Use muapi auth configure first if MUAPI_API_KEY is unset.
For model IDs without a CLI alias yet, fall back to the raw endpoint via curl -X POST https://api.muapi.ai/api/v1/<endpoint> -H "x-api-key: $MUAPI_API_KEY" -H 'content-type: application/json' -d '{...}' and poll with muapi predict wait <request_id>.
Substitute {{input_name}} placeholders with the user's actual inputs before issuing each call.

FAQ

What does the muapi-ugc-ads-workflow skill do?

Create a User-Generated Content (UGC) video ad by combining a human selfie and a product image, then generating a video script and an animated ad.

How do I install muapi-ugc-ads-workflow?

Run npx skills add https://github.com/samuraigpt/generative-media-skills --skill muapi-ugc-ads-workflow in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/muapi-ugc-ads-workflow/ (personal) or .claude/skills/muapi-ugc-ads-workflow/ (project).

Which AI agents can use muapi-ugc-ads-workflow?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is muapi-ugc-ads-workflow safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains muapi-ugc-ads-workflow?

It is published by samuraigpt in samuraigpt/generative-media-skills. It has 663 recorded installs.