Video Maker

Three skills for making product videos from screen recordings with HyperFrames and ffmpeg. They are the production rules Enconvo uses for its own launch films and tutorials, written down rule by rule as films were reviewed: what was tried, what the reviewer said, and the numbers that made it work.

A film always loads video-basics plus exactly one of the other two.

Use it

Ask your agent, in a project folder:

• "The master is at source/feature.skbundle. Make a launch video for it."
• "Make a step-by-step tutorial video for this feature."

skills/video-basics/references/project-setup.md describes the project layout the skills expect and how to set up render hosts.

Install what it needs

brew install ffmpeg node          # ffmpeg 7+, Node 22+
npx --yes hyperframes@0.7.61 browser ensure   # HyperFrames' headless Chrome
python3 skills/video-basics/scripts/recording/neatshot_take.py install   # NeatShot, the free screen recorder
bash skills/video-basics/scripts/check_setup.sh   # reports anything still missing

Python 3.10+ comes with the Command Line Tools. Voice-over, images and transcription use the running Enconvo; take analysis uses a Gemini key in .env. skills/video-basics/references/install-and-workflow.md has the full table and the whole loop, command by command: intake, timestamps, cuts, preview in the HyperFrames Studio, check, snapshot, render, verify, archive.

What's inside besides the rules

• skills/video-basics/assets/film-template/: a new film's skeleton (package.json with the preview, check, snapshot and render scripts, hyperframes.json, cuts.sh, STATUS.md, a minimal index.html).

• skills/video-basics/scripts/recording/: takes recorded with NeatShot from the command line (neatshot_take.py: a bare source video plus a pointer track), and hid / axwin for takes the agent drives.

• skills/video-basics/scripts/check_setup.sh and analyze_video.mjs: the setup check, and Gemini analysis of a take or a render.

• skills/video-basics/scripts/: remote_cuts.py and split_render.py run ffmpeg cuts and HyperFrames renders on one or more Macs over SSH (hosts in video-hosts.json), plus rms.py and luma.py for checking a render.

• skills/video-basics/references/kit/: the Python film kit Enconvo's films are built with, as reference code.

• skills/launch-video/references/example-popbar-launch/ and skills/tutorial-video/references/example-popbar-tutorial/: one complete film script of each kind.

• skills/launch-video/references/cinematic-shot/: 1weiho/cinematic-shot (MIT), vendored with its license.

Installs in Enconvo, Codex and Claude Code. The skills are regenerated from Enconvo's video repo by build_video_maker.py there; raise version in the three manifests for every release.