Replicate Video Ad skill
A Codex skill that breaks a reference video into timed shots and writes a prompt reusing its story mechanics for your own product.
- 117 ★ on the repository
- Last commit
Extended access
Why this level
- The script runs `ffmpeg` and writes frames to the chosen folder, and `yt-dlp` downloads video from links.
- Analyzing someone else's video calls for a copyright check on the reference.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add skills/replicate-video-adDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The script runs `ffmpeg` and writes frames to the chosen folder, and `yt-dlp` downloads video from links.
- Analyzing someone else's video calls for a copyright check on the reference.
This is third-party code. Review the repository files before installing.
What it does
Replicate Video Ad is a Codex skill that turns a reference video into a shot-by-shot analysis and a prompt for an ad story about your product. The `scripts/extract_video.py` script uses `ffmpeg` to sample up to two frames per second and builds a storyboard with contact sheets. From these the agent writes a timeline: action, dialogue or subtitles, scene role and the moment the product appears. It then breaks down hook, escalation, reversal, proof and call to action, and writes a master prompt with voice direction, post-production copy and a segmented generation plan. The skill keeps observations, adaptation decisions and unverified claims apart. While product facts are missing, placeholders such as `【产品名】` stay in the text and invented properties do not appear.
Who it is for. Marketers and producers of short video ads who carry the story mechanics of a successful reference over to their own product.
Good fit when
- A feed video needs a storyboard with second-by-second timing.
- A Douyin ad is prepared on a proven story beat but for a different product.
- A long video-model prompt is cut into segments and generated one after another.
- A team must separate confirmed product facts from invented slogans.
Not a fit when
- You want to copy faces, voices, logos or accounts of the author: the skill replaces them on purpose.
- The video cannot be opened locally or from a public link: there is nothing to analyze.
- You want a finished edited video: the skill writes text and tables and does not render video.
Example request
Use $replicate-video-ad to analyze this video and write a prompt for a 30-second ad story for my face cream.Limitations
The skill targets Codex and runtimes with folder-based skills. It needs Python 3.10 or newer and `ffmpeg` with `ffprobe`, plus `yt-dlp` for links. Analysis samples up to two frames per second rather than every frame. Dialogue enters the prompt only from subtitles, a permitted transcript or burned-in text. The repository states no license, so ask the author about reuse of its files. Rights to the reference video and advertising claims about the product are yours to verify.
How to disable. Delete the `~/.codex/skills/replicate-video-ad` folder and restart Codex. Frames and storyboards sit in the output folder you chose, so delete it separately.
FAQ
Can I give a link instead of a file?
Yes, the skill accepts a public link. Downloading needs the optional `yt-dlp`, and a local file is more reliable.
What appears in the output folder?
`storyboard.jpg`, `frames.zip`, `frame_manifest.json` and `.csv`, contact sheets and frames. The `--extract-audio` flag adds `audio.mp3`.
Will the skill invent product properties?
No. When facts are missing, placeholders such as `【核心卖点】` stay and confirmation is requested separately.
How many frames are taken?
Up to two per second: the sample command sets `--fps 2 --max-frames 120`. This is dense sampling, not every frame.
Does the skill work in Claude Code?
The README names Codex and other runtimes with folder-based skills. In other agents the skill folder must be placed into their skills directory by hand and tried on a test video.
Discussion
No questions or reviews yet.
Related
SkillsA Codex skill that produces a paper-collage ad: script, storyboard, animation, voiceover and a quality-checked MP4.
A skill for Claude Code and Codex that builds cinematic product videos with Remotion from shot recipe cards, a ready template and audio assets
A skill for Cursor, Claude Code and Codex: from a product name or URL it builds a 4K promo with music, voice-over and checks
A Claude Code skill that records a product in the browser, composes a video with chapters and captions and masters the MP4 locally
A skill for Claude Code and Codex that turns one sentence into a product launch film, scores the music and edits a frame on click
A Claude Code skill that builds a Remotion film of your product from its own components, tokens and logo, cut to music
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Repository stars | Main difference |
|---|---|---|---|
| Replicate Video Ad (this card) | no | 117 | |
| Ecom Video Seedance Prompt | no | 125 | analyzes an ad video and writes Seedance prompts; here the output is a timed shot timeline with a prompt not tied to one model |
| seedance-tvc-director | no | 344 | builds ads from a brief for Seedance 2.5; here the source is a finished reference video |
README in short
The README describes the output: a shot timeline, hook and proof breakdown, a master prompt, and rules for replacing faces, voices and logos. Python and `ffmpeg` requirements are listed separately.