product-video
Skill1 starsChanged 38 days agoMITView on GitHub
Make a clean narrated walkthrough video of a web app (intro, what's new, feature tour, training clip). HTML scenes built from the product's real CSS with invented data, captured frame by frame in headless Chrome, encoded to MP4 with WebCodecs, a local Kokoro voice, burned-in captions and soft music. No ffmpeg, no npm packages. Use when the user wants to make a video of an app, site, feature or release - "make a video", "intro video", "what's new video", "product tour", "walkthrough video", "/product-video" - or to change or re-render one.
9 other projects use a version of this.
Adopted by
Most recently taken up by
- mikeleg/skillstheir own version, first seen Nov 16, 2026
- rawphp/skillstheir own version, first seen Nov 1, 2026
- raphaeltm/simple-agent-managertheir own version, first seen Nov 1, 2026
- A19235972428/product-video-as-codetheir own version, first seen Nov 1, 2026
- kritikmodi/product-video-as-codetheir own version, first seen Nov 1, 2026
- Shop-OS/sloosh-plugintheir own version, first seen Oct 25, 2026
Other versions9 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 9
- raphaeltm/simple-agent-manager★ 73same name
- MatrixReligio/ProductVideoCreator★ 41same name
- sanky369/vibe-building-skills★ 30same name
- kritikmodi/product-video-as-code★ 7same name
- mikeleg/skills★ 1same name
- rawphp/skills★ 1same name
- A19235972428/product-video-as-code★ 0same name
- sagarmohansingh02-cloud/claude-skills★ 0same name
- Shop-OS/sloosh-plugin★ 0same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository5 other files it gives its agents.
- skills/fable-setup/templates/CLAUDE.mdCLAUDE.md
- delegateSkill
- fable-setupSkill
- tokenwatchSkill
- wrapSkill
The file
We split this skill into the rules it gives an agent
8 rules. 0 are common, 6 are distinctive, and 2 are very specific to this project.
0
Common
Most of the 8 edited versions we read keep these.
6
Distinctive
This author's own choices. Worth a look.
2
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 25
Every name, host, ticket, address and number on screen is invented and obviously so.
- Distinctive: line 28
No installs without the user's approval.
- Distinctive: line 35
Write a short script and get the user's yes before building anything.
- Very specific: line 56
Read kit/README.md (API and gotchas) and scenes/s01-example.html.
- Distinctive: line 100
Never commit the MP4 to the product's repo by default.
- Distinctive: line 107
A scene too short for its lines: Check words per second while writing the script.
- Distinctive: line 108
Script named a thing the code does not have: Check every label against the views.
- Very specific: line 110
hashsays DIFFERENT by a few pixels: after a big seek: Chrome finishes text raster late.
“Common” is measured: kept by at least 6 in 10 of the 8 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Product video: scenes in HTML, captured to MP4
The picture is not a screen recording. Each scene is an HTML page that draws the product from its real CSS, filled with invented data, where a fake cursor clicks, drags and types and a camera zooms in. Every frame is a pure function of time, so it renders the same every time and any line or beat can be changed and re-rendered in minutes.
template/ beside this file is a complete build folder: the stage kit, the tools, and one example scene.
What you need
- Node 24 (built-in WebSocket; no npm packages).
- Google Chrome (or Edge). It does the capture and the H.264/AAC encoding through WebCodecs. Set
CHROMEto its path if it is not the standard Windows install. - For the voice: Python 3.12 with
kokoro-onnx,numpy(seetemplate/kokoro/requirements.txt) and the two Kokoro model fileskokoro-v1.0.onnxandvoices-v1.0.binintemplate/kokoro/models/. Runs on CPU, offline. - Music (optional): any track you are licensed to use. Without one,
music.pysynthesizes a quiet chord bed.
Rules that apply every time
- Every name, host, ticket, address and number on screen is invented and obviously so. Page and button names are verbatim from the product's code. If the script and the code disagree, the code wins; say so.
- Facts only in the narration. Do not describe a feature you have not found in the code.
- No installs without the user's approval. Only voices and music licensed for the use.
- Claude cannot hear audio. Say so, and report levels as numbers; the user reviews by watching.
Steps
1. Script first
Write a short script and get the user's yes before building anything. One row per scene:
| # | Time | What is on screen | Narration (verbatim) |
Aim for 8 to 20 seconds a scene and under two minutes in total. Speech runs about 2.6 words per second at speed 0.9, so check each line fits its scene with room to spare. Read the product's views first so every name is real. Decide each scene's end state now, so scenes join cleanly.
2. Set up the build folder
Copy template/ to <project>/video/build/. Then:
- Fill in the paths at the top of
CONTRACT.md. - Snapshot the product's CSS and fonts into
site-css/, unedited, and note insite-css/SOURCES.mdwhat came from where and at which commit. If the product loads a font from a CDN, copy the file and declare it inkit/stage.css. - Optional: write
kit/shell.js+shell.cssthat draw the product's sidebar and top bar from its real classes, so every scene shares the same frame. - Prove the pipeline:
node tools/render.mjs check tools/selftest.htmlmust pass.
3. Build the scenes
Read kit/README.md (API and gotchas) and scenes/s01-example.html. Build the first real scene yourself so the look
is settled, then hand the rest to parallel subagents, one or two scenes each, each with its own PORT, using
SCENE_BRIEF.md as the brief. Look at every contact sheet yourself when they report.
4. Silent cut
List the scenes in film.json, then from the build folder:
OUT=<name> node tools/render.mjs film -> out/<name>.mp4 + .vtt + .vcache.json
node tools/verify.mjs out/<name>.mp4About 50 to 110 ms a frame. The cut is silent by design; tell the user before they open it.
5. Voice
PYTHONUTF8=1 kokoro/venv/Scripts/python.exe tools/voice.py out/<name>.vtt <film seconds>One recording per caption cue. Defaults: voice bm_george, en-gb, speed 0.9 (env VOICE, LANG_, SPEED;
KOKORO_DIR if Kokoro lives elsewhere). It prints each line's start and length and flags any line that is late
(pushed back because the line before ran long) or runs past the film end. Fix those in the scenes (caption t0
values and BEATS, or a longer scene), re-render, and re-run until nothing is late by more than about half a second.
6. Music and the final file
node tools/render.mjs decode "music/<file>.mp3" out/voice/music.wav (skip for the synthesized bed)
BED=out/voice/music.wav PYTHONUTF8=1 <python> tools/music.py -> out/voice/mix.wav
OUT=<name> node tools/render.mjs audio out/voice/mix.wav out/<name>-final.mp4 (reuses the cached picture)
node tools/verify.mjs out/<name>-final.mp4BED_DB (default -27 dBFS under speech) and GAP_DB (+5 dB between lines) set the music level; voice peaks at
-3 dBFS. OUT must match the film's, or audio cannot find the cached picture.
7. Hand off
- Poster frame:
node tools/render.mjs still scenes/<first>.html <t> out/<name>-poster.png, at a moment the camera is still. - Captions are burned in. A player must not also show the VTT by default.
- On a web page:
preload="none", open paused (browsers block autoplay with sound), serve with range requests. - Never commit the MP4 to the product's repo by default; hand over the file and its hash.
What went wrong the first time
- Too many repeated clicks. Show a repetitive action once or cut to the result.
- Narration late against the picture because scenes were timed before the voice existed. Step 5's loop fixes it; do it before the first voiced review.
- A scene too short for its lines. Check words per second while writing the script.
- Script named a thing the code does not have. Check every label against the views.
- Real source credits under invented data (a widget's "data from ..." line). Hide them.
hashsays DIFFERENT by a few pixels after a big seek: Chrome finishes text raster late.SETTLE_MS=1000.- Encoded bytes differ between identical runs. Compare decoded frames, never MP4 hashes.
Reference
template/tools/README.md: every command, environment variable, how capture and encode work, measured speed.template/kit/README.md:StageAPI (anim, camera, cursor, ring, spot, type, boot), scene skeleton, gotchas.template/CONTRACT.md,template/SCENE_BRIEF.md: the rules for scenes and the brief for scene agents.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

