sprezzature-video
Video claims
A README gets re-read. A number burned into a keyframe does not. This package holds a film’s assertions against the code they describe, in both directions, and answers whether the film can be rendered again at all from a clean clone.
Makes
- WebVTT from the narration script and the measured length of each audio file, not from a transcript and not typed by hand
- A poster baked as frame zero, because Slack, X and Discord regenerate their thumbnail server-side from the first frame whatever a
poster=attribute says - Loudness normalised across a series, so one film is not louder than the next
Audits
verify— every declared claim against the file that would have to change for it to stop being truescan— every number visible on screen that no claim accounts for, because the dangerous claim is the undeclared onepitch— problem, then solution, then underlying magic, in Guy KAWASAKI’s order, with a feature list refused where an insight belongsassets— can this film be rendered again from a clone? Tracked, derived, or exists in exactly one placeprose— the on-screen writing against the project’s charter, one finding per line
Say one of these
The skill triggers itself on phrasing like this, no command to memorize.
make a launch video
the demo video is out of date
verify the claims in this video
re-cut the film
is this number still right
can we rebuild this video
poster frame
Reference library
The knowledge the skill draws on: read them straight from the repo.
Frequently asked questions
How do I install sprezzature-video?
Run pip install sprezzature-video (Python 3.10 to 3.13): the command line, the HTTP API and the MCP server install with it, with no extra to choose. The command is sprezzature-video, also spelled make-film.
What does sprezzature-video need besides pip?
sprezzature-video needs only ffmpeg on PATH: poster and the loudness functions call it, and captions measures each narration audio file through ffprobe, which ships with ffmpeg. It runs no model, needs no GPU and calls no network service; verify, scan, prose, pitch and calque read text files and nothing else.
What is a claim in sprezzature-video?
In sprezzature-video, a claim is a fact a film states on screen, declared in the film's YAML spec as a pair: the text with its value, and the file in the project that decides it, read by one of five methods (json_len, json_key_len, regex_count, line_count, literal). A missing source file fails the claim instead of skipping it, so a count that moves in the code fails the check instead of quietly ageing the film.
What do verify, scan, assets and captions check in sprezzature-video?
In sprezzature-video, verify checks every declared claim against its file, scan lists the numbers visible in an HTML composition that no claim accounts for, and assets, the asset ledger, says whether each file the film renders from is tracked, derived or held in one place only, which decides whether a clone can render it again. captions writes WebVTT from the narration script and the measured length of each audio file, without transcribing anything.
How is sprezzature-video different from linting a video script?
sprezzature-video reads the project a film describes, not only its words: verify fails a number on screen when the code behind it changes, even if the script never did. It lints the script too, with prose (dashes, banned phrases, sentences opening on a negation, in English and French), and scan catches what a lint cannot see, a number typed into a keyframe that nobody declared.
Can I use sprezzature-video without Claude Code?
Yes: sprezzature-video is also a Python library (import sprezzature_video), a command line, an HTTP API with a Docker image, and an MCP server, sprezzature-video-mcp, serving the API and /mcp on one port. The HTTP and MCP surfaces cover verify, scan and captions; the skill comes from pip install sprezzature then sprezzature-skills --install, or sprezzature-skills --install --agent opencode.
Can I run sprezzature-video in CI?
Yes: every sprezzature-video command exits 0 when the film is still honest, 1 when it is not (a claim that fails, a number nobody declared, an asset not in hand) and 2 on a wrong call or a missing ffmpeg, so sprezzature-video verify film.yaml --root . can fail a pull request. sprezzature-video prose script.txt --strict is made for a pre-commit hook.
Is sprezzature-video free?
Yes: sprezzature-video is open source under the BSD 3-Clause licence, with no account, API key or paid tier, and its source is on GitHub. It is still alpha, and it renders nothing itself: the films are made with Hyperframes, outside the package.