Skip to content
Back to search

remotion-ad-video-skill

Create Remotion ad video projects from a URL with an AI coding agent, no video-generation AI required.

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/leosssvip-dot--remotion-ad-video-skill/badge.svg)](/listings/leosssvip-dot--remotion-ad-video-skill)

HTML

<a href="/listings/leosssvip-dot--remotion-ad-video-skill"><img src="/api/listings/leosssvip-dot--remotion-ad-video-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.

You do not need to install this manually. Open your coding agent and ask it to install the skill for you.

Copy this prompt:

Install the remotion-ad-video skill from this repository into my available
skills directory. Use a symlink if my agent supports it; otherwise copy
skills/remotion-ad-video. After installing, tell me how to reload or restart the
agent so the skill becomes available.

For Codex/OpenAI-compatible agents, the agent should install `skills/remotion-ad-video/` into the local skills directory, then ask you to reload the skill list.

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 · 374 lines

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

  1. # remotion-ad-video-skill
  2. [中文说明](README.zh-CN.md)
  3. Create editable ad video projects from a URL with an AI coding agent. The skill
  4. plans the ad, then renders with either [Remotion](https://github.com/remotion-dev/remotion)
  5. or [Hyperframes](https://github.com/heygen-com/hyperframes). No video-generation AI required.
  6. Remotion is the React/TS path. Hyperframes is the HTML/CSS/GSAP path. The skill
  7. auto-selects the renderer from explicit user choice, existing project stack, and
  8. local availability, then records the reason in `ad-brief.json`.
  9. This is an agent-agnostic workflow: any coding agent that can read files and run
  10. Node scripts can use it.
  11. ## Demo Video
  12. https://github.com/user-attachments/assets/98b0fb8f-e05f-4743-a4d2-ca0b01c1e2d0
  13. https://github.com/user-attachments/assets/56fd55e5-af66-4737-b12b-88034d1fad52
  14. https://github.com/user-attachments/assets/d39807fa-ffc4-4229-a98d-bb11738d747c
  15. https://github.com/user-attachments/assets/d93f65f0-cb47-47b5-a8d6-a20be31c0553
  16. https://github.com/user-attachments/assets/5dbe2ade-fe7f-419f-8349-d73045320cd2
  17. https://github.com/user-attachments/assets/8e3605dc-f776-4f62-b763-f618f6d7f8d8
  18. ## Why This Exists
  19. Most AI video workflows send a prompt to a video model and wait. This skill
  20. takes a different path:
  21. ```text
  22. URL -> source classification -> ad-brief.json -> assets -> storyboard -> render-engine code -> draft video
  23. ```
  24. That makes the output editable, repeatable, brand-safe, and testable in code.
  25. It is designed for ads where the product, CTA, claims, format, and asset rights
  26. matter.
  27. ## Features
  28. - URL-to-ad workflow for ecommerce products, mobile games, social/content apps,
  29. SaaS/API products, local services, and generic mobile apps.
  30. - Mandatory `ad-brief.json` contract so source type, creative route, format,
  31. render engine, render-engine reason, audio mode, asset requirements,
  32. assumptions, and blockers are explicit before storyboard or code.
  33. - Link-adapted preflight choices for output format and creative route.
  34. - Audible generated SFX are used by default for draft ads unless you choose a
  35. silent-safe output; sound is not a required preflight question by default.
  36. - Creative QA pushes bold ad layouts: poster-scale hooks, one dominant visual,
  37. aggressive crops, and lower text density.
  38. - Ecommerce asset harvester with blocked-page detection and a fail-closed rule:
  39. if the product image cannot be confidently harvested, stop and request user
  40. assets.
  41. - Fast Remotion lab for low-resolution stills, preview MP4, half-size draft
  42. MP4, and explicit full-size final render.
  43. - Hyperframes compatibility with an HTML starter template, `variables.json`,
  44. and `npx hyperframes lint/inspect/preview/render` QA flow.
  45. - Validation script for checking the skill package structure and key workflow
  46. contracts.
  47. - Synthetic URL demo showing URL to Remotion ad video without third-party media.
  48. ## Repository Layout
  49. ```text
  50. skills/remotion-ad-video/
  51. SKILL.md Main agent skill entrypoint
  52. agents/openai.yaml Optional OpenAI/Codex listing metadata
  53. references/ Workflow contracts and category playbooks
  54. assets/remotion-template/ Reusable Remotion starter project
  55. assets/hyperframes-template/ Reusable Hyperframes HTML starter project
  56. scripts/build_asset_manifest.mjs Skill-local asset manifest helper
  57. scripts/
  58. classify-ad-source.mjs URL/source classifier and ad-brief generator
  59. create-open-source-snapshot.mjs Allowlisted sanitized publish snapshot
  60. harvest-ecommerce-assets.mjs Ecommerce product image harvester
  61. fast-ad-lab.mjs Shared Remotion draft render runner
  62. validate-skill.mjs Local structure/workflow validator
  63. examples/synthetic-url-ad/
  64. ad-brief.json Fake URL brief, safe to publish
  65. src/ CSS-only Remotion demo, no external media
  66. ```
  67. ## Requirements
  68. - Node.js 20+
  69. - npm or another Node package manager
  70. - Chrome or Chromium for browser-backed ecommerce harvesting
  71. - For Remotion output: Remotion dependencies installed in the active project
  72. and a valid Remotion license for the intended commercial use
  73. - For Hyperframes output: Node.js 22+ and FFmpeg for `npx hyperframes`
  74. - Rights-cleared product images, logos, music, SFX, voiceover, and claims for
  75. production ads
  76. ## Agent Compatibility
  77. The workflow is generic and can be used by any coding agent that can read local
  78. files and run Node scripts.
  79. - Codex / OpenAI-compatible skill loaders can install `skills/remotion-ad-video/`
  80. directly.
  81. - Claude Code, Cursor, Windsurf, or other agents can load
  82. `skills/remotion-ad-video/SKILL.md` as the playbook and use the scripts in
  83. `scripts/`.
  84. - The deterministic parts are plain Node scripts plus Remotion and Hyperframes
  85. templates; they are not tied to one agent runtime.
  86. ## Install With Your AI Agent
  87. You do not need to install this manually. Open your coding agent and ask it to
  88. install the skill for you.
  89. Copy this prompt:
  90. ```text
  91. Install the remotion-ad-video skill from this repository into my available
  92. skills directory. Use a symlink if my agent supports it; otherwise copy
  93. skills/remotion-ad-video. After installing, tell me how to reload or restart the
  94. agent so the skill becomes available.
  95. ```
  96. For Codex/OpenAI-compatible agents, the agent should install
  97. `skills/remotion-ad-video/` into the local skills directory, then ask you to
  98. reload the skill list.
  99. ## Quick Start
  100. Use it from your AI agent. Give the agent a URL and ask it to create an ad
  101. video project:
  102. ```text
  103. Use the remotion-ad-video skill to create a 15s ad video for this product:
  104. https://example.com/products/focus-lamp
  105. ```
  106. Or with the OpenAI/Codex skill trigger:
  107. ```text
  108. Use $remotion-ad-video to create a 15s vertical ad video for:
  109. https://example.com/products/focus-lamp
  110. ```
  111. The agent should:
  112. 1. Classify the URL and create `ad-brief.json`.
  113. 2. Ask the two required creative preflight choices by default.
  114. If the agent supports selectable UI, it should use choices for size
  115. and creative route; otherwise it should ask only those same two options in
  116. text before any optional follow-up questions. Audio defaults to synced SFX.
  117. 3. Harvest or request usable assets.
  118. 4. Propose ad concepts and pick the strongest route.
  119. 5. Create or update the selected render project. The agent chooses by explicit
  120. user choice, existing project stack, then local renderer availability.
  121. 6. Run the matching render-engine QA before any final MP4.
  122. 7. Report rights, asset, and claim gaps.
  123. For normal use, you should let the agent run the scripts, create the render
  124. project, and render the draft. You do not need to run validation commands.
  125. ## Renderer Usage
  126. Default auto-selection:
  127. 1. Explicit user choice.
  128. 2. Existing target project stack.
  129. 3. Local renderer availability.
  130. 4. Ask when both engines are available; recommend installing one when neither
  131. is available.
  132. Use the remotion-ad-video skill with auto selection:
  133. ```text
  134. Use $remotion-ad-video to create a 15s vertical ad for:
  135. https://example.com/products/focus-lamp
  136. ```
  137. Force Remotion:
  138. ```text
  139. Use $remotion-ad-video to create a 15s vertical Remotion ad for:
  140. https://example.com/products/focus-lamp
  141. ```
  142. Force Hyperframes:
  143. ```text
  144. Use $remotion-ad-video to create a 15s vertical Hyperframes ad for:
  145. https://example.com/products/focus-lamp
  146. ```
  147. Remotion output uses `assets/remotion-template/`, `src/default-props.json`, and:
  148. ```bash
  149. npm run typecheck
  150. npm run still
  151. npm run render
  152. ```
  153. Hyperframes output uses `assets/hyperframes-template/`, `variables.json`, and:
  154. ```bash
  155. npx hyperframes lint
  156. npx hyperframes inspect --samples 12
  157. npx hyperframes preview
  158. npx hyperframes render --variables-file ./variables.json --quality draft
  159. ```
  160. ## Synthetic URL Demo
  161. The repository includes a safe demo at `examples/synthetic-url-ad/`.
  162. It starts from a fake product URL:
  163. ```text
  164. https://example.com/products/focus-lamp
  165. ```
  166. The demo includes:
  167. - `ad-brief.json` with the inferred ecommerce ad brief.
  168. - `storyboard.md` with a 15s structure.
  169. - `src/` with a CSS-only Remotion ad video.
  170. - No third-party brand assets.
  171. - No generated-video AI output.
  172. Ask your agent to run it:
  173. ```text
  174. Use the remotion-ad-video skill to run the synthetic URL demo. Install any local
  175. dependencies needed for examples/synthetic-url-ad, render one still frame first,
  176. then render the demo video if the still looks correct.
  177. ```
  178. ## Fast Render Workflow
  179. When you want faster iteration, ask the agent to use the fast render workflow.
  180. The important rule is simple:
  181. 1. Render low-resolution still frames first.
  182. 2. Render a low-resolution preview only if motion timing needs review.
  183. 3. Render a half-size draft MP4 for normal review.
  184. 4. Render full-size output only after you approve the draft.
  185. Copy this prompt:
  186. ```text
  187. Use the fast Remotion ad workflow: render low-resolution stills first, then a
  188. half-size draft MP4 only if the stills are correct. Do not render full-size video
  189. until I approve the draft.
  190. ```
  191. ## Recommended Agent Prompt
  192. ```text
  193. Use $remotion-ad-video to turn this product or app link into a 15s ad.
  194. Create ad-brief.json first, ask the two required preflight choices,
  195. harvest usable assets, propose three concepts, implement the strongest one in
  196. Remotion, render low-resolution stills before any MP4, and report rights or
  197. asset gaps.
  198. ```
  199. If you want a no-question speed run, say so explicitly. The agent can then use
  200. inferred defaults, but it must still write them into `ad-brief.json`.
  201. ## Output Artifacts
  202. A normal ad build should produce:
  203. - `ad-brief.json`: source type, goal, CTA, creative route, format,
  204. render engine, render-engine reason, audio mode, assumptions, unresolved
  205. questions, and blockers.
  206. - `public/<brand>/`: approved or harvested source assets.
  207. - `src/default-props.json`: Remotion props for scenes, dimensions, CTA, assets,
  208. - `src/default-props.json` for Remotion, or `variables.json` for Hyperframes:
  209. scenes, dimensions, CTA, assets, claims, and audio settings.
  210. - Draft stills under `examples/<ad>/out/draft/`.
  211. - Optional preview, draft MP4, and final MP4 under `examples/<ad>/out/`.
  212. ## Safety And Rights
  213. - Do not imply this project grants rights to third-party product photos,
  214. screenshots, logos, music, voices, SFX, reviews, or store assets.
  215. - Do not render unverified numeric claims, regulated claims, customer data,
  216. private URLs, API keys, tokens, or internal payloads.
  217. - If ecommerce crawling is blocked or the main product image is not credible,
  218. stop and request user-provided product images.
  219. - Drafts include generated SFX by default. Music, voiceover, or special sound
  220. assets still need clear usage rights when requested.
  221. - Confirm Remotion licensing separately for commercial rendering and deployment.
  222. For Hyperframes, confirm the project can run Node.js 22+ and FFmpeg.
  223. ## Maintainer Checks
  224. These commands are for maintainers and contributors, not normal skill users.
  225. Run before publishing or opening a pull request:
  226. ```bash
  227. npm run validate
  228. ```
  229. Create a sanitized release snapshot:
  230. ```bash
  231. npm run snapshot
  232. ```
  233. Optional smoke tests:
  234. ```bash
  235. node scripts/classify-ad-source.mjs \
  236. "https://play.google.com/store/apps/details?id=com.king.candycrushsaga" \
  237. --title "Candy Crush Saga" \
  238. --brief-out /tmp/candy-ad-brief.json
  239. node scripts/fast-ad-lab.mjs stills examples/example-ad --frames 30,150 --scale 0.25
  240. ```
  241. ## Maintainer Release Checklist
  242. This checklist is for maintainers preparing a public release. Normal users do
  243. not need it.
  244. - Create a sanitized snapshot instead of uploading the working directory:
  245. ```bash
  246. node scripts/create-open-source-snapshot.mjs
  247. ```
  248. The snapshot is written to `dist/open-source-snapshot/` and intentionally
  249. excludes `.remotion/`, `node_modules/`, render outputs, harvested media, local
  250. task records, env files, and unreviewed examples. The reviewed synthetic demo is
  251. included.
  252. - Choose and add a `LICENSE` file before publishing. This repository does not
  253. choose one for you.
  254. - Remove or ignore `node_modules`, Remotion `out` folders, caches, draft MP4s,
  255. and any generated screenshots.
  256. - Review `examples/*/public/` before publishing; the default `.gitignore`
  257. excludes it because it may contain harvested or generated media.
  258. - Do not publish local agent task records such as `docs/tasks/` or
  259. `docs/PROGRESS.md` unless they have been reviewed and sanitized.
  260. - Remove third-party scraped media unless you have redistribution rights.
  261. - Replace private product links, customer names, tokens, local absolute paths,
  262. and one-time IDs in examples or docs.
  263. - Keep only examples that are either fully synthetic or explicitly licensed for
  264. redistribution.
  265. - Run the validation commands above.
  266. - Tag the first release as pre-1.0 if the API and workflow may still change.
  267. ## Limitations
  268. - This is a skill and workflow package, not a hosted rendering service.
  269. - The classifier is deterministic and heuristic-based; agents should still
  270. verify source context before production work.
  271. - Ecommerce pages may block crawling. The correct fallback is to request user
  272. images, not to fabricate product visuals.
  273. - Ad creative quality still depends on the brief, usable assets, and iteration.
  274. ## Contributing
  275. Keep changes scoped and verifiable:
  276. - Update or add reference files when the workflow changes.
  277. - Prefer deterministic scripts for repeated or fragile steps.
  278. - Run `npm run validate` before submitting changes.
  279. - Do not commit generated render output, dependencies, secrets, or unlicensed
  280. third-party media.

Ratings and comments

Sign in to rate this skill.

Sign in

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