cinetic (cinema + kinetic) is an agent skill that makes your coding agent direct a short film instead of arranging animation components. It is built for the two films a product team makes most: the launch film and the update video ("v2 is out", with the three things that changed).
- Clear copy first. Before any picture, the agent writes a script a stranger understands in 5 seconds: what the product is by 3 s, then one thing it does a line, then the name and what to do, in 2–7 plain words a line.
copy-check.py reads it the way a stranger would and fails vague words, slogans and keyword piles.
- One line at a time, each with its own animation. Every line of the script arrives its own way, from twenty-three tested text animations and a book of 466 devices, while the camera keeps the picture moving. A hero line lands solid and leaves at speed, and seams carry the object and the speed into the next shot.
- Templates for the films teams make most.
new-film.sh --template lays down a whole film's structure: an update video, a UI walkthrough, a capability reel, a camera teaser, a prompt run, a social ad or a type explainer. For a film whose idea is its own device, the agent is dealt an art direction instead.
- The product, built in code. Its screens come back as live components at film size: dense screens with one readable line, panels tilted in one light, a camera that moves through depth, portraits instead of grey silhouettes, and data that adds up on every frame.
- Real marks of the products it works with.
logos.mjs fetches the official colour marks of a product's integrations, sources and models from open collections and records source, licence and trademark owner. The kit sets them as app-icon tiles, chips, marks inside a line, walls and rings. Generic glyphs are Phosphor Icons.
- Type in one step. Inter at its display cut by default, or a free face dealt from a set by look (neutral, tight, geometric, friendly, technical); two measured type families, calm or bold, set with one command; and
font-match.mjs picks the free face closest to a brand face that cannot ship.
- Your brand, or one it makes. Hand it a brand kit (logo, colours, fonts, screenshots) and
brand.py writes it into the film. Without one, it designs a brand from three personality words. A clip you supply can lend the film its grammar, never its content.
- Music-led sound. Every film is cut to its own licensed, human-made instrumental track, found by mood, tempo and length, with a sound cast for each action from an earshot kit and a library of real effects. No music is generated, nothing copyrighted enters a repository, and credits never appear in the picture.
- Finished and measured. True motion blur, no banding, BT.709 and a sync-checked mux, then gates that fail motion that snaps, freezes or stops dead, floors against a flat picture, checks against filler shapes and unmotivated light, pixel forensics, an audio-sync audit, contact sheets and critic passes against a ship gate.
It builds with Remotion (React) by default, or HyperFrames (HTML and GSAP).
Quick start · Examples · Start a film · Install · Requirements · Use · How it works · Sound · Look · What's inside · Evaluation
Quick start
npx skills add Leonxlnx/cinetic
Then ask your agent for a film, for example: "Make a 25-second launch film with music for our database branching tool. Invent the brand." It works with Claude Code, Codex, Cursor and the other agents the skills CLI supports.
Before the first film, check your machine with a first test render. It needs Node 22+, ffmpeg 6+, Python 3.11+ and a headless Chromium, plus earshot 0.4 for the sound; see Requirements.
Examples
Every film here was made by an agent with cinetic 1.5 from a one-paragraph brief and cut to a licensed music track. The brands are invented unless the brief supplied one. Clicking a GIF downloads its MP4. The films live on the repo's media branch, so installs stay small.
Start a film
The agent scaffolds the project itself at intake. These are the commands it runs, and you can run them too (<skill> is where the skill is installed, for example ~/.claude/skills/cinetic):
# a launch film from the starter, for an idea that is its own device
bash <skill>/scripts/new-film.sh films/acme --fps 60 --size 1920x1080
# a film template laid over the starter
bash <skill>/scripts/new-film.sh films/acme-walk --template ui-walkthrough
# an update video in a supplied brand, cut to a track found with music.mjs
bash <skill>/scripts/new-film.sh films/acme-2 --template update --brand ./brand \
--music ./audio/track.mp3 --record ./audio/track.licence.json
new-film.sh copies the starter (and the template), sets the grid, copies every cinetic script into the project so it runs on its own, and installs its dependencies. Other flags: --type calm|bold (the type family), --like <clip> (a clip's grammar), --pace crisp, --engine hyperframes, --font <name> and --link-modules <dir>; --format update is the same as --template update. new-film.sh --help lists them all.
This is the beginning of the README. Read the rest at the original. Read the full README ↗
