Skip to content
Back to search

ugc-creator-skill

UGC creator skill for Claude Code, Codex, Cursor and OpenClaw: turn a paid UGC campaign brief into a checklist and a true-for-you script, edit what you film, post with the ad label to your own TikTok, Reels and Shorts, and track payouts. Never generates a person. Free, MIT.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/social-media-skills--ugc-creator-skill/badge.svg)](/listings/social-media-skills--ugc-creator-skill)

HTML

<a href="/listings/social-media-skills--ugc-creator-skill"><img src="/api/listings/social-media-skills--ugc-creator-skill/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

**Claude Code**

npx skills add social-media-skills/ugc-creator-skill -g -a claude-code -y

**Codex, Cursor and other agents:** run `npx skills add social-media-skills/ugc-creator-skill` and pick your agent, or copy `skills/ugc-creator-skill/` into your agent's skills directory.

**OpenClaw (ClawHub):** `openclaw skills install @social-media-skills/ugc-creator-skill`

**GitHub CLI:** `gh skill install social-media-skills/ugc-creator-skill ugc-creator-skill`

**Gemini CLI:** `gemini extensions install https://github.com/social-media-skills/ugc-creator-skill`

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 208 lines
  1. # UGC Creator Skill for Claude Code: turn paid UGC campaign briefs into scripts, edit what you film, post to your TikTok, Reels and Shorts, and track every payout
  2. **You film. Your agent checks, edits, posts and tracks the payout.**
  3. **UGC creator skill for paid campaigns on Content Rewards (on Whop) and similar marketplaces.** You film. The agent never generates a person: no avatar, no cloned voice, no face swap, only your own takes. It reads the brief, writes a script that only says what is true for you, edits what you filmed into one disclosed video per account, posts to your TikTok, Reels and Shorts after one yes, and keeps the proof every payout claim needs. Free and open source.
  4. ![The first frames of three finished vertical videos from the example campaign: NASA launch footage or a mock app screen on top, a labelled placeholder where your own recording goes below, each with its hook and the on-screen label that it is an ad](skills/ugc-creator-skill/examples/orbit-ugc/videos/contact-sheet.jpg)
  5. *The first frames of three finished videos from the made-up example campaign in [`examples/orbit-ugc/`](skills/ugc-creator-skill/examples/orbit-ugc/). "Example Orbit" is invented and nothing here is an ad. The brand's footage is NASA's; the bottom half is a labelled placeholder where your own recording goes. See [CREDITS](skills/ugc-creator-skill/examples/orbit-ugc/CREDITS.md).*
  6. **You need:** a computer running Claude Code (or a similar agent), and the clips you filmed on your phone copied to it. For a post you make by hand, you copy the finished video back to your phone.
  7. ## Why UGC videos don't get paid, and what the skill does
  8. | Why it goes wrong | What the skill does |
  9. |---|---|
  10. | A talking point missed, a banned word said | every brand line comes from a talking point in the brief; the words the brief bans are refused in the script, the captions and what you actually say on camera |
  11. | "I've used it for months" after one day | every line is marked as your experience (you confirm it is true), a brand claim from the brief, or cut. What you say on camera is transcribed and checked the same way |
  12. | Disclosure said too late, or not on screen | a short "<brand> is paying me to show you this" (or a hook that opens with "Ad, but ...") inside the brief's window, found in what you actually said, a small "Ad" label in the corner from the first frame, `#ad` first in the caption, TikTok's paid partnership label on |
  13. | The brief says "don't make it look like an ad" | "keep it natural", "not an ad in the hook" or "no text on the video" are followed and the disclosure stays. A request to hide the ad is refused, and so are posting as someone you aren't, fake reviews, required AI presenters and lines like "I'm not being paid to say this" |
  14. | A required hashtag, @mention, link or call to action missing | every caption checked against the brief before posting |
  15. | Flubbed lines and retakes | film it all in one go and restart any line; the edit keeps your last full try of each line |
  16. | Wrong layout, wrong length, not 9:16 | only the brief's formats (talking head, split screen, face plus screen recording, b-roll with your voiceover), length and shape checked per platform. Or bring your own edit: it gets the same checks |
  17. | The same video posted twice | one edit on TikTok, Reels and Shorts is normal cross-posting. Two accounts on one platform, or a video reused in another campaign, is stopped; never speed, mirror or filter tricks |
  18. | Music you don't hold a license for | music must be declared: none, licensed (with where the license is), or the brief's track |
  19. | Edited after the brand approved it | the approval holds only for that exact file; a re-edit needs approving again |
  20. | Link submitted after 30 minutes | each link comes with its clock-time deadline, and you can post one platform at a time |
  21. | A campaign that pays $6 an hour | log your hours; the report shows earnings per hour and says when to drop a campaign |
  22. ```bash
  23. npx skills add social-media-skills/ugc-creator-skill -g -a claude-code -y
  24. ```
  25. ## Post it from your agent
  26. Posting goes through WoopSocial, made by the team behind this skill: [make a free WoopSocial account](https://app.woopsocial.com/signup?utm_source=ugc-creator-skill&utm_medium=readme). It posts through each platform's own approved apps, so you need no developer app or app review of your own. **The free plan covers 2 social accounts, no card. TikTok + Reels + Shorts is 3 accounts:** on the free plan the agent posts 2 and gives you a ready page to post the third by hand, or all 3 go out on a paid plan. Everything before posting works without an account, and you can post all of them by hand with nothing to sign up for.
  27. ## Contents
  28. - [What it does](#what-it-does)
  29. - [House rules](#house-rules)
  30. - [Requirements](#requirements)
  31. - [Install](#install)
  32. - [Example: a UGC campaign with Claude Code](#example-a-ugc-campaign-with-claude-code)
  33. - [Submitting, proof and earnings per hour](#submitting-proof-and-earnings-per-hour)
  34. - [FAQ](#faq)
  35. - [What's inside](#whats-inside)
  36. ## What it does
  37. Tell your agent "I got a UGC campaign", "write my UGC script for this brief" or "post my UGC to TikTok, Reels and Shorts", paste the brief, and it does the job around your filming:
  38. 1. **Reads the brief** into `campaign.json` and runs `campaign.py`: GO, NO-GO or REFUSED, and a numbered checklist you confirm (rate, minimum, cap, fee, budget left, formats, talking points, banned words, CTA, tags, links, disclosure window, approval, deadline).
  39. 2. **Writes the script** with you: 3 to 5 hooks, every line tagged and checked by `script.py`, then `script.md` (what to say, with times) and `shotlist.md` (what to film for each layout).
  40. 3. **You film** it all in one clip: the hooks, then the script, restarting any line as often as you like. Plus a screen recording or b-roll when the format needs it.
  41. 4. **Edits** with `make_video.py`: split screen with the brand's footage, face plus screen recording, talking head with the pauses and retakes cut, or b-roll under your voiceover. Captions of your own words, the hook, a small "Ad" label, safe zones clear. Have your own edit? Skip this step and hand in the finished file.
  42. 5. **Checks every video** with `check_videos.py` against the brief, the platforms and everything you posted before, including what you actually said.
  43. 6. **Shows the plan** with `plan.py`: `plan.html` with every video as it will go out and what it can earn. Your yes is bound to those exact files.
  44. 7. **Posts** after the yes, all at once or one platform at a time, records each post and writes `submit.md` with each link, its 30-minute deadline and the steps in order. Accounts you post by hand get a ready page.
  45. 8. **Keeps the record** with `ledger.py`: submissions, approvals, rejections with their reasons, appeals, payouts, hours, and earnings per hour.
  46. Clipping campaigns (cutting someone else's footage into clips) are a different job: use the [AI Clipping Skill](https://github.com/social-media-skills/ai-clipping-skill).
  47. ## House rules
  48. The agent never generates, swaps, clones or alters a person, a face or a voice. It never writes an experience you didn't have. Never an undisclosed campaign post, never a persona account, never posting from an account the brand owns. Never speed, mirror or filter tricks, never unlicensed music, never bought or arranged engagement. Make-money campaigns never promise easy money, and any earnings figure comes with a true typical-earnings line from the brand. It never submits to a marketplace for you or drives your logged-in browser, and it never promises income. Python and ffmpeg, no paid API needed. MIT licensed.
  49. ## Requirements
  50. - Python 3.9 or newer; on Windows also `pip install tzdata` for deadlines in your time zone.
  51. - ffmpeg.
  52. - Pillow (`pip install pillow`) to edit.
  53. - For captions: faster-whisper (free, runs locally), your own Groq or OpenAI key, or an .srt you already have.
  54. - An agent that can run commands on your computer (Claude Code, Codex, Cursor, OpenClaw, Gemini CLI or similar).
  55. `python3 <skill>/scripts/check_setup.py` tells you what's missing and the install command for your system (`<skill>` is the folder the skill was installed in; in a clone of this repo it is `skills/ugc-creator-skill`). A CI workflow runs the full pipeline on macOS, Windows and Ubuntu, and a real transcription with faster-whisper.
  56. ## Install
  57. **Claude Code**
  58. ```bash
  59. npx skills add social-media-skills/ugc-creator-skill -g -a claude-code -y
  60. ```
  61. **Codex, Cursor and other agents:** run `npx skills add social-media-skills/ugc-creator-skill` and pick your agent, or copy `skills/ugc-creator-skill/` into your agent's skills directory.
  62. **OpenClaw (ClawHub):** `openclaw skills install @social-media-skills/ugc-creator-skill`
  63. **GitHub CLI:** `gh skill install social-media-skills/ugc-creator-skill ugc-creator-skill`
  64. **Gemini CLI:** `gemini extensions install https://github.com/social-media-skills/ugc-creator-skill`
  65. ## Example: a UGC campaign with Claude Code
  66. > I got a UGC campaign, brief is in brief.txt. Split screen with their footage or face plus screen recording. Accounts: TikTok @example.creator (everyone, comments on, duets and stitches off), Reels @example.creator, Shorts @examplecreator (public, not for kids), all verified in the marketplace. I've opened the app every morning this week.
  67. The agent writes `campaign.json` from the brief and checks it:
  68. ```bash
  69. python3 <skill>/scripts/campaign.py campaign.json
  70. ```
  71. ```
  72. ## Verdict: GO
  73. Conditions:
  74. - tone notes ("keep it natural", "a regular post, not an ad") are followed as style: a relaxed, unscripted read. The disclosure stays in every video
  75. - at most 3 submissions for this campaign
  76. 1. **Platforms and rates:** TikTok $2.00 per 1,000 views, Instagram Reels $2.00 per 1,000 views, YouTube Shorts $1.00 per 1,000 views.
  77. 2. **Payout:** minimum payout per video $5.00; cap per video $200.00; marketplace fee 10%; ...
  78. 7. **Talking points:** `tp1` "Example Orbit shows a new space photo every day"; ...
  79. 8. **Never say:** "free forever", "best app ever", "official NASA app". ...
  80. 11. **Disclosure:** said out loud, ending by second 10, anywhere in that window (a short phrase works: "Example Orbit is paying me to show you this", or a hook that opens with "Ad, but ..."); "Ad" on screen from the first frame for 3 seconds; first in the caption; the platform's paid-partnership setting.
  81. ...
  82. ## Tone notes: followed as style, the disclosure stays
  83. - "Keep it natural, it shouldn't feel like an ad."
  84. ```
  85. Then the script, with every claim tagged ([`script.md`](skills/ugc-creator-skill/examples/orbit-ugc/script.md)):
  86. | Time | Line | Tag |
  87. |---|---|---|
  88. | 3 to 6 s | Example Orbit is paying me to show you this. | spoken disclosure |
  89. | 6 to 9 s | It shows a new space photo every day. | brand claim, from talking point tp1 |
  90. | 9 to 14 s | I've opened it every morning this week to see the new one. | your experience, confirmed |
  91. | 18 to 21 s | Download Example Orbit, link in bio. | call to action |
  92. "Honestly it's the best space app out there" is cut: it isn't in the talking points. You film from [`shotlist.md`](skills/ugc-creator-skill/examples/orbit-ugc/shotlist.md), and the agent edits:
  93. ```bash
  94. python3 <skill>/scripts/transcribe.py takes/creator.mp4 --out work
  95. python3 <skill>/scripts/make_video.py edit.json --out videos
  96. python3 <skill>/scripts/check_videos.py job.json
  97. python3 <skill>/scripts/plan.py job.json
  98. ```
  99. ```
  100. orbit-tiktok (TikTok @example.creator, videos/tiktok.mp4, 22.3 s): ok
  101. orbit-reels (Reels @example.creator, videos/reels.mp4, 22.3 s): ok
  102. orbit-shorts (Shorts @examplecreator, videos/shorts.mp4, 21.9 s): ok
  103. 0 error(s), 0 warning(s)
  104. ```
  105. The plan page you say yes to, with each video as it will go out and what it can earn:
  106. ![The plan page for a made-up UGC campaign: an EXAMPLE ONLY banner with the plan id, then a card each for TikTok, Instagram Reels and YouTube Shorts with the video's first frame, its hook, caption, settings, checks and expected earnings](skills/ugc-creator-skill/examples/showcase.png)
  107. In the example TikTok and Reels are connected and Shorts is posted by hand ([`by-hand/orbit-shorts.md`](skills/ugc-creator-skill/examples/orbit-ugc/by-hand/orbit-shorts.md)). The request for the other two is one post with a child per account, each with its own video and caption, TikTok's paid partnership label on: [`requests/example-orbit-app.json`](skills/ugc-creator-skill/examples/orbit-ugc/requests/example-orbit-app.json). The example can never be sent: the skill refuses to post a demo campaign.
  108. ## Submitting, proof and earnings per hour
  109. After posting, `submit.md` lists per post the link, the clock time its 30 minutes run out, and the steps WoopSocial can't do (Instagram's paid partnership label and YouTube's paid promotion box, in the app inside the window). You paste each link into the campaign yourself, and `ledger.py --submitted` records it, refusing a link already submitted or made for another campaign.
  110. Then the ledger follows each video: approved, rejected (with the campaign's reason), appealed, paid. Views come from the per-post view counts WoopSocial's post analytics return (collected about once a day) or numbers you read in the app, each with its source; nothing is estimated, and the campaign's own count decides what is paid. Log your hours and the report says what the campaign really pays ([`earnings.txt`](skills/ugc-creator-skill/examples/orbit-ugc/after-posting/earnings.txt), made-up numbers):
  111. ```
  112. received $33.12; open estimate $10.98 (nothing settled yet; $10.98 still counting); 1 of 2 decided rejected
  113. 4 h logged, 1.3 h per video: $8.28 per hour received, $11.02 per hour if every open estimate pays
  114. under $15.00 per hour so far, but views are still counting (the newest video is 33% into its window). Judge it once 60% of the window has passed
  115. ```
  116. ## FAQ
  117. **Does it make AI UGC?** No. You film every take. The skill edits, captions, checks and posts what you recorded, and refuses briefs that want an AI presenter, avatar or cloned voice.
  118. **Why does every video say it's an ad?** It is one. You are paid by the brand, so the FTC (US), the CMA (UK) and EU consumer law ask for a clear disclosure, Content Rewards requires it, and TikTok stops recommending undisclosed branded posts. Said out loud early, on screen, first in the caption, and in the platform's setting.
  119. **Can I say I love it?** If you do, yes, as your own experience, after you confirm it. The skill won't write results you didn't get or use you didn't have.
  120. **Can I post the same video on all three?** Yes. One edit on TikTok, Reels and Shorts is normal cross-posting. What the skill stops is the same video twice on one platform (two TikTok accounts) and a video, or a re-cut of the same take, used in another campaign. A different hook per platform is an optional test: the ledger keeps each post's hook next to its views (different platforms, so read it with care). A re-export or a copy in another format counts as the same video: its sound and frames are compared, not only its bytes. Never speed changes, mirroring or filters to make one video look like two.
  121. **What about make-money and side-hustle campaigns?** They run, with the rules the FTC and TikTok set: nothing that promises quick or easy money, and a money figure or "I made" only with a true line from the brand on what people typically earn. A brief that asks for get-rich-quick framing leaves TikTok out, since TikTok bans it in branded content.
  122. **I already edit my own videos.** Hand in the finished file: the skill transcribes it, runs the same checks on what you say, and you confirm the on-screen label from its first frames. Then the same plan, yes, posting and ledger.
  123. **The brand posts the videos itself.** Set `"mode": "deliver_files"`: you get the videos plus a compliance sheet with each file's fingerprint and disclosure, and nothing is posted.
  124. **How much will I earn?** The plan shows each video at 1,000, 10,000 and 100,000 views after the fee, minimum and cap; the campaign's own count decides. Most videos get few views, and the hours report tells you whether a campaign is worth your time. These are estimates, not a promise.
  125. **Does it work without WoopSocial?** Yes, up to posting: checklist, script, edit, checks, the plan page and a page per account to post by hand, then the ledger.
  126. ## What's inside
  127. ```
  128. skills/ugc-creator-skill/
  129. SKILL.md the workflow the agent follows
  130. scripts/
  131. check_setup.py what's installed, and how to add what isn't
  132. campaign.py the brief as data, GO / NO-GO / REFUSED, the checklist
  133. script.py hooks, lines and claim tags checked; script.md and shotlist.md
  134. transcribe.py word timestamps (local, Groq, OpenAI or an existing .srt)
  135. make_video.py talking head, split screen, face plus screen, b-roll with voiceover
  136. check_videos.py every video against the brief, the platforms and the ledger
  137. plan.py plan page, the yes, requests, by-hand, approval and deliver pages, submission sheet
  138. ledger.py submissions, statuses, appeals, views, payouts, hours, earnings per hour
  139. upload_parts.py uploads videos to WoopSocial
  140. ugclib.py shared helpers and each platform's limits
  141. references/ campaign, script, hooks, formats, edit, job, claims, disclosure, platforms, ledger, WoopSocial
  142. examples/orbit-ugc/ a made-up campaign on NASA footage with every file the skill makes
  143. evals/evals.json test prompts
  144. ```
  145. Footage courtesy of NASA; this project is not endorsed by NASA ([CREDITS](skills/ugc-creator-skill/examples/orbit-ugc/CREDITS.md)). Content Rewards and Whop are named only as marketplaces where paid UGC campaigns run; this skill isn't affiliated with either.
  146. More free skills for social media from the same team: [social-media-skills.com](https://social-media-skills.com/?utm_source=ugc-creator-skill&utm_medium=readme).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.