Skip to content
Back to search

dansugc

MarketplaceWorks with Claude CodeGitHub

DansUGC plugins for coding agents: turn the product in your repo into short-form UGC ads with real human creators.

Safety scan

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

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/dansugc--reelclaw/badge.svg)](/listings/dansugc--reelclaw)

HTML

<a href="/listings/dansugc--reelclaw"><img src="/api/listings/dansugc--reelclaw/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

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

These steps run a script from the network that findsafeskills does not scan.

You need two things: the **`dansugc` MCP server** (`https://dansugc.com/mcp`, OAuth) and the **`reelclaw` skill**. The Claude Code and Codex plugins bundle both.

Claude Code

/plugin marketplace add dansugc/reelclaw
/plugin install reelclaw@dansugc

Then run `/mcp`, select **plugin:reelclaw:dansugc**, and choose **Authenticate** (browser login to your DansUGC account). Now ask:

> Make 3 UGC ads for this app with DansUGC ReelClaw. Use the demo in ./demo.mp4.

Or use the slash command: `/reelclaw:new 3 ./demo.mp4 gen-z, deadpan, snapchat-style captions`. The skill itself is `/reelclaw:reelclaw` (Claude also picks it up automatically).

Shell equivalents: `claude plugin marketplace add dansugc/reelclaw` and `claude plugin install reelclaw@dansugc`.

Updating (terminal): `claude plugin marketplace update dansugc`, then `claude plugin update reelclaw@dansugc`, then restart Claude Code.

OpenAI Codex

Option A — plugin (skill + MCP server in one, updates with `codex plugin marketplace upgrade`):

codex plugin marketplace add dansugc/reelclaw
codex plugin add reelclaw@dansugc
codex mcp login dansugc

Option B — MCP server + skill via script:

codex mcp add dansugc --url https://dansugc.com/mcp
codex mcp login dansugc
curl -fsSL https://raw.githubusercontent.com/dansugc/reelclaw/main/codex/install.sh | sh

`install.sh` is POSIX `sh`, idempotent, needs no sudo: it copies the skill into `~/.agents/skills/reelclaw` (Codex's user skills directory: `SKILL.md`, `references/`, `agents/openai.yaml`), replacing the folder so files from older versions don't linger, removes a retired `~/.agents/skills/reelclaw-ads`, and adds the `dansugc` MCP server if it isn't configured yet. Start a new Codex session, then ask:

> $reelclaw Make 3 UGC ads for this app. Use the demo in ./demo.mp4.

Optional: paste [`codex/AGENTS.md`](codex/AGENTS.md) into your project's `AGENTS.md`, and see [`codex/config.toml`](codex/config.toml) for the manual `~/.codex/config.toml` block.

Any other agent (Cursor, OpenCode, Gemini CLI, Kimi Code, VS Code, Zed, …)

1. Add a remote (streamable HTTP) MCP server named `dansugc` with the URL `https://dansugc.com/mcp` (no headers) and log in when prompted (OAuth). 2. Install the skill with the open [`skills`](https://github.com/vercel-labs/skills) CLI:

   npx skills add dansugc/reelclaw/plugins/reelclaw/skills/reelclaw -a <agent> -y

(`<agent>` is the skills CLI id, e.g. `cursor`, `opencode`, `gemini-cli`; add `-g` for every project.) Clients that upload skills by hand (claude.ai, Claude Desktop): upload the [`plugins/reelclaw/skills/reelclaw`](plugins/reelclaw/skills/reelclaw) folder.

Signing in

The DansUGC MCP server uses **OAuth only**: you log in with your DansUGC account in the browser once and your agent stays connected. Any DansUGC account can connect, with or without a plan. DansUGC API keys (`dsk_…`) don't work on MCP; they're for the REST API (`/api/v1`) only. If you added the server earlier with an `Authorization` header or `bearer_token_env_var`, remove it and log in with OAuth (see Troubleshooting).

---

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.

.claude-plugin/marketplace.json · Manifest · 27 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "name": "dansugc",
  3. "description": "DansUGC plugins for coding agents: turn the product in your repo into short-form UGC ads with real human creators.",
  4. "owner": {
  5. "name": "DansUGC",
  6. "email": "dan@dansugcmodels.com",
  7. "url": "https://dansugc.com"
  8. },
  9. "plugins": [
  10. {
  11. "name": "reelclaw",
  12. "source": "./plugins/reelclaw",
  13. "description": "Make TikTok/Reels UGC ads for the product in your repo: real human reaction hooks from DansUGC (or your own footage) + your demo, edited and rendered locally by your agent with the reelclaw engine (7 templates, playbook, frame-by-frame QA). Works on any DansUGC account; editing is free and only new library clips and research queries cost credits.",
  14. "category": "marketing",
  15. "tags": [
  16. "ugc",
  17. "ads",
  18. "tiktok",
  19. "reels",
  20. "video",
  21. "marketing",
  22. "mcp",
  23. "hyperframes"
  24. ]
  25. }
  26. ]
  27. }
README.md · README · 283 lines · 1 finding marked

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # DansUGC ReelClaw for coding agents
  2. Make short-form UGC ads (TikTok, Reels, Shorts) for the product you're building — from inside
  3. Claude Code, OpenAI Codex, or any agent that speaks MCP.
  4. Your agent reads your repo to understand the product, finds your demo video, writes TikTok-native
  5. hooks, and pairs them with real human creator reactions from the DansUGC library (or your own
  6. footage). Then it **edits and renders every reel on your machine** with the open-source
  7. [reelclaw engine](https://github.com/danielhangan/reelclaw-templates) (7 viral templates, TikTok
  8. Sans, safe-zone captions), **looks at the rendered frames** with `reelclaw qa` and a QA checklist,
  9. and fixes what's off before handing you the file. You can ask for any edit in plain words: "move
  10. the caption up", "cut on her reaction", "box-style captions", "5 more hook variants".
  11. > **ReelClaw 3.0: built on the reelclaw engine.** The plugin no longer carries its own copy of the
  12. > craft. Each repo gets one reel project, `./reelclaw-studio/`, set up by the reelclaw installer:
  13. > 7 templates, content-cached media, `reelclaw make` / `qa` / `batch` / `render`, and the
  14. > `reelclaw-playbook` skill (brief, hooks, footage, music, QA checklist, variants). This plugin is
  15. > the DansUGC layer on top: sign-in, credits and teams, real-creator clips, viral formats,
  16. > trending music, research and posting. Coming from 2.x? See [Upgrading from 2.x](#upgrading-from-2x).
  17. No Gemini key, no API keys: you log in once with your DansUGC account (OAuth). Any DansUGC
  18. account works, no plan needed; you pay per clip from your credits. Editing and rendering are local and
  19. free. Needs Node 22+ and ffmpeg.
  20. > Every reaction is a real human creator. Never AI.
  21. ---
  22. ## 60-second quickstart
  23. You need two things: the **`dansugc` MCP server** (`https://dansugc.com/mcp`, OAuth) and the
  24. **`reelclaw` skill**. The Claude Code and Codex plugins bundle both.
  25. ### Claude Code
  26. ```
  27. /plugin marketplace add dansugc/reelclaw
  28. /plugin install reelclaw@dansugc
  29. ```
  30. Then run `/mcp`, select **plugin:reelclaw:dansugc**, and choose **Authenticate** (browser login to
  31. your DansUGC account). Now ask:
  32. > Make 3 UGC ads for this app with DansUGC ReelClaw. Use the demo in ./demo.mp4.
  33. Or use the slash command: `/reelclaw:new 3 ./demo.mp4 gen-z, deadpan, snapchat-style captions`.
  34. The skill itself is `/reelclaw:reelclaw` (Claude also picks it up automatically).
  35. Shell equivalents: `claude plugin marketplace add dansugc/reelclaw` and
  36. `claude plugin install reelclaw@dansugc`.
  37. Updating (terminal): `claude plugin marketplace update dansugc`, then
  38. `claude plugin update reelclaw@dansugc`, then restart Claude Code.
  39. ### OpenAI Codex
  40. Option A — plugin (skill + MCP server in one, updates with `codex plugin marketplace upgrade`):
  41. ```sh
  42. codex plugin marketplace add dansugc/reelclaw
  43. codex plugin add reelclaw@dansugc
  44. codex mcp login dansugc
  45. ```
  46. Option B — MCP server + skill via script:
  47. ```sh
  48. codex mcp add dansugc --url https://dansugc.com/mcp
  49. codex mcp login dansugc
  50. curl -fsSL https://raw.githubusercontent.com/dansugc/reelclaw/main/codex/install.sh | sh
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 70 on GitHub
  51. ```
  52. `install.sh` is POSIX `sh`, idempotent, needs no sudo: it copies the skill into
  53. `~/.agents/skills/reelclaw` (Codex's user skills directory: `SKILL.md`, `references/`,
  54. `agents/openai.yaml`), replacing the folder so files from older versions don't linger, removes a
  55. retired `~/.agents/skills/reelclaw-ads`, and adds the `dansugc` MCP server if it isn't configured
  56. yet. Start a new Codex session, then ask:
  57. > $reelclaw Make 3 UGC ads for this app. Use the demo in ./demo.mp4.
  58. Optional: paste [`codex/AGENTS.md`](codex/AGENTS.md) into your project's `AGENTS.md`, and see
  59. [`codex/config.toml`](codex/config.toml) for the manual `~/.codex/config.toml` block.
  60. ### Any other agent (Cursor, OpenCode, Gemini CLI, Kimi Code, VS Code, Zed, …)
  61. 1. Add a remote (streamable HTTP) MCP server named `dansugc` with the URL `https://dansugc.com/mcp`
  62. (no headers) and log in when prompted (OAuth).
  63. 2. Install the skill with the open [`skills`](https://github.com/vercel-labs/skills) CLI:
  64. ```sh
  65. npx skills add dansugc/reelclaw/plugins/reelclaw/skills/reelclaw -a <agent> -y
  66. ```
  67. (`<agent>` is the skills CLI id, e.g. `cursor`, `opencode`, `gemini-cli`; add `-g` for every
  68. project.) Clients that upload skills by hand (claude.ai, Claude Desktop): upload the
  69. [`plugins/reelclaw/skills/reelclaw`](plugins/reelclaw/skills/reelclaw) folder.
  70. ### Signing in
  71. The DansUGC MCP server uses **OAuth only**: you log in with your DansUGC account in the browser once
  72. and your agent stays connected. Any DansUGC account can connect, with or without a plan. DansUGC API keys (`dsk_…`) don't work on MCP; they're for the REST API
  73. (`/api/v1`) only. If you added the server earlier with an `Authorization` header or
  74. `bearer_token_env_var`, remove it and log in with OAuth (see Troubleshooting).
  75. ---
  76. ## How a run goes
  77. 1. **Studio**: from your repo, the agent sets up (or reuses) one reel project,
  78. `./reelclaw-studio/`, with the reelclaw installer: the templates it needs, the engine, and the
  79. `reelclaw-playbook` skill. It asks before adding `reelclaw-studio/` and `reelclaw-output/` to
  80. your `.gitignore`.
  81. 2. **Brief**: it reads your README, `package.json`, store listing, and landing copy, and shows you
  82. a short brief (what it is, who it's for, the painful problem, the aha moment, real proof). It
  83. never invents claims, prices, or results.
  84. 3. **Formats (free)**: unsure what to make? It asks DansUGC which formats went viral in your niche
  85. (with example TikToks and views) and maps your pick to a template.
  86. 4. **Research (optional)**: real viral examples via TikTok/Instagram search, 0.02 credits per
  87. query; the agent says how many it plans to run first.
  88. 5. **Hooks**: lowercase, under 80 characters, specific to the pain or the aha; reviewed with you.
  89. 6. **Footage**: your own clips, or DansUGC reactions: it shortlists library clips → quotes the
  90. price → **nothing is bought until you say yes** (clips you already own are free).
  91. 7. **Music**: trending sounds for your niche (0.02 credits per lookup), with the licensing note for
  92. ads; or silent, to add a sound in the app.
  93. 8. **Make + QA**: `reelclaw make … --draft` renders locally and runs `reelclaw qa`; the agent looks
  94. at every frame it lists (hook timing, safe zone, font, the cut, audio) and fixes what's off (max
  95. 3 passes). Hook variants run as one `reelclaw batch`.
  96. 9. **Deliver**: finals in `./reelclaw-output/`. Ask for more hook variants, another template, any
  97. edit, or publishing through DansUGC Posting.
  98. | Template | What it makes |
  99. |---|---|
  100. | `reaction-demo` | creator reaction + hook → hard cut → your app demo (the default for app ads) |
  101. | `wall-of-text` | faceless POV / storytime text in TikTok's white box over b-roll |
  102. | `listicle` | "3 apps that feel illegal to know" countdown, one clip or screenshot per item |
  103. | `no-yapping` | silent split-screen tutorial: intro gag, typing shot over a screen recording |
  104. | `greenscreen-reaction` | the creator cut out (local AI) talking over a video or screenshot |
  105. | `talking-head-captions` | talking-to-camera clip with word-by-word captions, pauses cut, b-roll |
  106. | `before-after` | transformation reveal (swipe or split) from a before and an after |
  107. Every reel is a plain HyperFrames composition (`reelclaw-studio/reels/<name>.html`), so anything
  108. the template flags don't cover (caption style, exact position, a second caption) the agent edits
  109. directly and re-renders.
  110. ## What to expect
  111. Measured on an Apple M1 Max (Node 26, ffmpeg 7.1, `hyperframes@0.8.181`, headless Chrome already
  112. cached), 2026-10-23:
  113. | Step | Time |
  114. |---|---|
  115. | Set up `reelclaw-studio/` from GitHub (`npx --yes github:danielhangan/reelclaw-templates add reaction-demo --dir reelclaw-studio`, incl. `npm install` and `doctor`; warm npm cache) | ~12 s |
  116. | `npx reelclaw make reaction-demo … --draft --workers 2` for a 10.9 s reel (stage 2 clips, generate, render, QA) | 18-22 s |
  117. | `npx reelclaw render <name> --quality delivery --workers 2` (same reel) | ~19 s |
  118. The first `add` from GitHub downloads the engine and its dependencies, and the first render ever
  119. downloads headless Chrome: allow a few minutes once. Hook variants reuse the cached media and cost
  120. one render each. (The 2.x timings for the per-concept template copies no longer apply.)
  121. ## What it costs
  122. The DansUGC MCP works on any DansUGC account, no plan needed. You pay as you go from your DansUGC
  123. credit balance:
  124. - **Editing and rendering: free.** They run on your machine.
  125. - **UGC clips you buy.** Library clips are 11 credits each (images 8), less your plan's discount
  126. (no volume discounts; always current rates). Clips you already own are reused for free.
  127. - **Research queries** (TikTok/Instagram search, trending music): 0.02 credits per query, charged
  128. only when the query succeeds. Viral-format suggestions and library search are free.
  129. - Prices, quotes, and balances are in DansUGC credits; the agent talks in credits and only
  130. converts to dollars if you ask.
  131. - The agent always shows the exact clip price first and waits for an explicit yes
  132. (`purchase_videos` is two-step: a free quote, then the buy). Team members can charge a team's
  133. credits instead of their own; the agent always names which account pays. Top up at
  134. https://dansugc.com/dashboard/credits.
  135. ## Privacy
  136. - DansUGC never receives your code, your demo, or your renders. The agent sends DansUGC only search
  137. queries, the short product description used for format suggestions, and the purchases you
  138. approve. Everything else stays on your machine (`./reelclaw-studio/`, `./reelclaw-output/`).
  139. - Publishing through DansUGC Posting uploads only the video you choose to post.
  140. ## Troubleshooting
  141. | Symptom | Fix |
  142. |---|---|
  143. | Agent says no `dansugc` tools | The MCP server isn't connected. Claude Code: `/mcp` → authenticate `plugin:reelclaw:dansugc`. Codex: `codex mcp list`, then `codex mcp login dansugc`. |
  144. | Agent tries `reelclaw_create_batch` / `reelclaw_render` and gets "tool not found" | An old (1.x) plugin or skill is installed. Those hosted tools were removed in 2.0. Update (see the quickstart) and delete any old `reelclaw-ads` skill folder. |
  145. | "Needs authentication" / 401 | Log in again (same commands). |
  146. | `reelclaw_login_required`, or "no longer accepts API keys — reconnect with OAuth" | The server was added with an API key. MCP is OAuth-only. Claude Code: `claude mcp remove dansugc`, re-add it without `--header` (or use the plugin), then `/mcp` → Authenticate. Codex: delete `bearer_token_env_var` from `[mcp_servers.dansugc]` in `~/.codex/config.toml`, then `codex mcp login dansugc`. |
  147. | `insufficient_credits` | Top up at https://dansugc.com/dashboard/credits, then ask the agent to re-quote. |
  148. | Codex doesn't see the skill | Start a new session. Check `~/.agents/skills/reelclaw/SKILL.md` exists (Option B) or `codex plugin list` shows `reelclaw@dansugc` (Option A). |
  149. | Node, ffmpeg or Chrome problems | In `reelclaw-studio/`: `npx reelclaw doctor` prints what's missing and the install line (Node 22+ is required). |
  150. | Render "succeeded" but animations / font / audio look wrong | `npx reelclaw qa <name>` in `reelclaw-studio/` lists render warnings, black/frozen frames and silent audio; the full log is `renders/<name>.render.log`. |
  151. | `npm error 404 … registry.npmjs.org/reelclaw` | `npx reelclaw` ran outside `reelclaw-studio/`. Run it inside that folder. Until the npm package is published, set up with `npx --yes github:danielhangan/reelclaw-templates add <template> --dir reelclaw-studio`. |
  152. | First render is slow | One-time HyperFrames + headless Chrome download. |
  153. | Something else | Support: https://dansugc.com |
  154. ## What's in this repo
  155. ```
  156. .claude-plugin/marketplace.json Claude Code marketplace "dansugc" (Codex reads it too)
  157. .agents/plugins/marketplace.json Codex-native marketplace "dansugc"
  158. plugins/reelclaw/
  159. .claude-plugin/plugin.json Claude Code plugin manifest
  160. .codex-plugin/plugin.json Codex plugin manifest
  161. .mcp.json dansugc → https://dansugc.com/mcp (HTTP, OAuth, 120 s tool timeout)
  162. skills/reelclaw/ THE ReelClaw skill (single source for every agent)
  163. SKILL.md connect + costs + accounts, set up reelclaw-studio/, follow the
  164. playbook, the DansUGC steps (formats, clips, music, research), deliver
  165. references/
  166. tools.md MCP tool map (inputs, results, prices, accounts/teams, packages)
  167. errors.md MCP error playbook (incl. removed tools) + local rendering pointers
  168. publishing.md DansUGC Posting: presign → PUT → create_post, error fixes
  169. agents/openai.yaml Codex UI metadata + MCP dependency
  170. commands/new.md Claude Code slash command /reelclaw:new
  171. codex/
  172. install.sh skill + MCP installer for Codex (curl | sh)
  173. config.toml manual ~/.codex/config.toml block
  174. AGENTS.md snippet for your project's AGENTS.md
  175. ```
  176. What the agent installs into your repo (from
  177. [danielhangan/reelclaw-templates](https://github.com/danielhangan/reelclaw-templates)):
  178. ```
  179. reelclaw-studio/
  180. templates/<id>/ the templates you use (template.mjs, SKILL.md, README.md)
  181. .claude/skills/reelclaw-playbook/ the producer playbook (Codex: .agents/skills/…), incl.
  182. references/dansugc.md with every DansUGC rule
  183. .claude/skills/<id>/ each template's skill (Codex: .agents/skills/<id>/)
  184. footage/ props/ your clips, DansUGC downloads, input files
  185. reels/ renders/ renders/qa/ compositions, MP4s, QA frames + reports
  186. reelclaw-output/ delivered finals
  187. ```
  188. Maintainers: bump `version` in both `plugins/reelclaw/.claude-plugin/plugin.json` and
  189. `plugins/reelclaw/.codex-plugin/plugin.json` to ship an update (a set version pins users until it
  190. changes). Validate with `claude plugin validate . && claude plugin validate ./plugins/reelclaw`.
  191. ## Upgrading from 2.x
  192. - Update the plugin (Claude Code: `claude plugin marketplace update dansugc` +
  193. `claude plugin update reelclaw@dansugc`; Codex plugin: `codex plugin marketplace upgrade dansugc`;
  194. script installs: re-run `install.sh`, which removes the old `references/` and `scripts/` files).
  195. - 2.x made one template copy per concept (`reelclaw-studio/<template>-<slug>/`) and drove it with
  196. the plugin's own generator wrapper and QA script. 3.0 uses one reel project for every reel:
  197. `reelclaw-studio/` holds the templates, cached media, `reels/` and `renders/`. Old per-concept
  198. folders can stay next to it (or be deleted once you've kept the MP4s you want); clips in
  199. `reelclaw-studio/footage/` are reused as they are, and owned DansUGC clips are never charged
  200. again.
  201. - Template ids are kebab-case now (`reaction-demo`, `no-yapping`, `greenscreen-reaction`); the old
  202. snake_case ids still work as aliases. Four templates are new: `wall-of-text`, `listicle`,
  203. `talking-head-captions`, `before-after`.
  204. - Renders use HyperFrames 0.8 (pinned by the engine), and QA is `reelclaw qa` (timeline-aware
  205. frames + report) instead of the plugin's frame script.
  206. - Nothing changes on the DansUGC side: same sign-in, credits, prices, tools and two-step purchases.
  207. ## Verified against (2026-10-23)
  208. Claude Code 2.1.283 and Codex CLI 0.162.1, plus:
  209. - Claude Code — create a marketplace: https://code.claude.com/docs/en/plugin-marketplaces
  210. - Claude Code — marketplace reference (schema, sources, reserved names): https://code.claude.com/docs/en/plugins/marketplace-reference
  211. - Claude Code — plugin manifest reference (`plugin.json`, standard layout, `.mcp.json`): https://code.claude.com/docs/en/plugins-reference
  212. - Claude Code — MCP (`--transport http`, `/mcp` OAuth, plugin MCP servers and tool naming): https://code.claude.com/docs/en/mcp
  213. - Claude Code — skills (frontmatter, `$ARGUMENTS`, `/plugin:skill` namespacing, commands merged into skills): https://code.claude.com/docs/en/skills
  214. - Agent Skills open standard (SKILL.md frontmatter limits, progressive disclosure): https://agentskills.io/specification
  215. - Codex — MCP (`[mcp_servers.<name>]`, `url`, `codex mcp add --url`, `codex mcp login`): https://developers.openai.com/codex/mcp (→ learn.chatgpt.com/docs/extend/mcp?surface=cli)
  216. - Codex — skills (`~/.agents/skills`, repo `.agents/skills`, `$skill` invocation, `agents/openai.yaml`): https://developers.openai.com/codex/skills (→ learn.chatgpt.com/docs/build-skills)
  217. - Codex — plugins (`.codex-plugin/plugin.json`, marketplace at `.agents/plugins/marketplace.json` or legacy `.claude-plugin/marketplace.json`, `codex plugin marketplace add owner/repo`): https://developers.openai.com/plugins/build/plugins
  218. - reelclaw engine (`danielhangan/reelclaw-templates`: `reelclaw add | make | qa | batch | render |
  219. doctor`, the `reelclaw-playbook` skill, `hyperframes@0.8.181`, Node 22+).
  220. Local checks run for 3.0: `claude plugin validate` on the marketplace and the plugin; `install.sh`
  221. run twice into a scratch skills dir (the second time over planted stale 2.x files and a
  222. `reelclaw-ads` folder, which it removed); and the skill's flow in two scratch product repos (the
  223. real GitHub installer, and a local checkout): `add reaction-demo --dir reelclaw-studio`, the
  224. playbook present in `.claude/skills/` and `.agents/skills/`, then
  225. `npx reelclaw make reaction-demo --props props/<name>.json --draft --workers 2` inside
  226. `reelclaw-studio/` (rendered, `reelclaw qa` ran), `batch --dry-run`, a delivery-quality `render`,
  227. and the copy to `reelclaw-output/`.

Ratings and comments

Sign in to rate this skill.

Sign in

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