Show HN: Brief2mp4 – ClaudeCode/Codex skill that checks videos against the brief Qualixar released brief2mp4, a free MIT-licensed agent skill for Claude Code and Codex that turns a written video brief into a finished MP4 and then checks the output against every line of that brief. The skill routes each beat to HyperFrames for type and 2D motion, Three.js for stylised 3D, an optional 3D pack for CAD models, materials and physics, and Blender for photoreal shots, then finishes with ffmpeg and returns final.mp4 plus a REPORT.md documenting evidence for each brief line; everything runs locally. In the project's run of example 01, the check pass caught headlines that cleared the 120 px minimum by only a few pixels, enlarged them and re-rendered. Text to motion graphics for Claude Code and Codex. Write a video brief, get a finished MP4 that has been checked against every line of it. 2D explainers · maths animations · tutorials · Shorts and Reels · data stories · product launches · logo stings · kinetic type · 3D products Quick start quick-start · What it makes what-it-makes · How it works how-it-works · 3D pack the-3d-pack · Edit pack the-edit-pack · Examples examples · Write a brief write-a-brief · Docs https://github.com/qualixar/brief2mp4/blob/main/docs/README.md · FAQ faq brief2mp4 is a free, MIT-licensed agent skill. You paste a written brief length, size, exact words, what happens when . The agent writes a spec with a checkable "done when" list, routes each beat to the right tool HyperFrames for type and 2D motion, Three.js for stylised 3D, an optional 3D pack for CAD models, materials and physics, Blender for photoreal shots , renders, finishes the file with ffmpeg, measures it, looks at real frames, fixes what misses and hands you final.mp4 with a REPORT.md that shows the evidence for every line. Everything runs on your own machine. ▶ Watch the video https://youtu.be/l9mEZQon6JM · All 11 contest films, untouched https://drive.google.com/drive/folders/1yBmCb2h63Fp5yr 37LY46f8BSRa 3GiO?usp=sharing · Free 69-page guide https://qualixar.com/learn/guides/brief2mp4-guide · How it was built https://qualixar.com/research/blog/brief2mp4-deep-dive Fastest: let your agent set everything up. Open Claude Code or Codex in any folder and send: Set up brief2mp4 from https://github.com/qualixar/brief2mp4 https://github.com/qualixar/brief2mp4 by following its SETUP.md. The agent detects your OS, asks before installing Node, ffmpeg and Git Bash on Windows , installs the skill, runs the doctor and makes a 12-second test video so you know it works. SETUP.md https://github.com/qualixar/brief2mp4/blob/main/SETUP.md is the exact script it follows. Or install it yourself: | You use | Run | |---|---| | Claude Code plugin | /plugin marketplace add qualixar/brief2mp4 then /plugin install brief2mp4@brief2mp4 | | Codex plugin | codex plugin marketplace add qualixar/brief2mp4 then codex plugin add brief2mp4@brief2mp4 | | macOS / Linux / WSL both apps | git clone https://github.com/qualixar/brief2mp4.git && bash brief2mp4/install.sh | | Windows PowerShell both apps | git clone https://github.com/qualixar/brief2mp4.git; powershell -ExecutionPolicy Bypass -File .\brief2mp4\install.ps1 -InstallTools | Add the 3D pack with --with-3d macOS/Linux or -With3D core Windows , and the edit pack with --with-edit or -WithEdit film,sound . Plugins install the skill only, so on a fresh machine also install the tools below. Start a new session after installing so the app loads the skill. Then make a video. In a folder for the video: Use the brief2mp4 skill to make the video in this brief: paste your brief When it says it is done, send one follow-up: Check it against the brief. That makes the agent go back to your original brief line by line, show the evidence for each line, fix what falls short and render again. In our run of example 01 it caught headlines that cleared the 120 px minimum by only a few pixels, enlarged them and rendered again. | Tool | Needed for | macOS | Windows | Ubuntu / Debian | |---|---|---|---|---| | Node.js 22+ | every video | brew install node | winget install -e --id OpenJS.NodeJS.LTS | nodesource setup 22.x https://github.com/nodesource/distributions | | ffmpeg | every video | brew install ffmpeg | winget install -e --id Gyan.FFmpeg | sudo apt install ffmpeg | | Git Bash | Windows only the scripts are bash | | winget install -e --id Git.Git | | | Blender 4.2+ | photoreal shots optional | brew install --cask blender | winget install -e --id BlenderFoundation.Blender | blender.org/download https://www.blender.org/download | | Python 3.12 or 3.13 | the 3D pack optional | brew install python@3.12 | winget install -e --id Python.Python.3.12 | Ubuntu 24.04: sudo apt install python3 python3-venv Debian 12 ships 3.11: uv python install 3.12 , then install with B2M3D PYTHON="$ uv python find 3.12 " , see uv https://docs.astral.sh/uv/ | Check a machine at any time with bash plugin/skills/brief2mp4/scripts/doctor.sh . It prints ok or the exact install command for each tool. Round 4 of the video: Fable 5.2 in Claude Code got a written brief for a 60-second film, one continuous camera move through four worlds with its own music, and delivered this. That was a sealed contest run made without this skill; brief2mp4 packages the same loop spec, build, measure, check every line, fix so you can run it on your own briefs. The full films https://drive.google.com/drive/folders/1yBmCb2h63Fp5yr 37LY46f8BSRa 3GiO?usp=sharing are untouched, with checksums. | Format | What the skill does for it | Route | |---|---|---| | 2D explainers YouTube, courses | hook, setup, three-step idea, example, takeaway; diagrams that draw on, labels word by word | HyperFrames | | Maths and algorithms | equations term by term, colour-coded to the picture; one transformation per beat | HyperFrames + KaTeX, or Manim https://github.com/ManimCommunity/manim inserts | | Tutorial intros and callouts | title and chapter cards, callouts and zooms over your screen recording | HyperFrames + your recording | | Stories and skits | situation, want, obstacle, turn; timing pauses before the punchline; captions to the voice | HyperFrames, SVG, Lottie or Rive characters | | YouTube Shorts, Reels, TikTok | 9:16 safe zones, a hook in the first frame, a change every 2-4 s, loopable endings | HyperFrames | | Data stories | charts that draw from the baseline, numbers that count to the exact value | HyperFrames + SVG/D3 | | Product launches | problem, reveal, features, call to action; real UI recreated sharp | HyperFrames, 3D pack, Blender | | Logo stings and titles | build-up, resolve on the sound accent, hold | HyperFrames, 3D pack | | Kinetic type and lyric videos | words timed to measured audio, stress shown with scale and weight | HyperFrames | | Stylised 3D | planets, particles, abstract shapes, flying cameras | Three.js | | 3D products with physics | parts that drop and settle, exploded views, turntables | 3D pack | | Photoreal shots | glass, metal, soft shadows | Blender | Examples 05 a 20 s explainer and 06 a 15 s vertical Short , each made by running the skill on the brief as written: both passed check delivery.sh , and their sample https://github.com/qualixar/brief2mp4/blob/main/examples/05-2d-explainer/SAMPLE-REPORT.md reports https://github.com/qualixar/brief2mp4/blob/main/examples/06-vertical-short/SAMPLE-REPORT.md list the evidence for every line, including the fixes the self-check forced. Every format has a beat sheet, a route and its own checks in references/formats.md https://github.com/qualixar/brief2mp4/blob/main/plugin/skills/brief2mp4/references/formats.md , which the agent reads when your brief names the kind of video. Proof the skill works: example brief 01, pasted as written, came back as a 12.000 s, 1920x1080, 30 fps file that passed the delivery check. Its report https://github.com/qualixar/brief2mp4/blob/main/examples/01-kinetic-type/SAMPLE-REPORT.md lists every requirement with its evidence: which still shows which line, the measured headline height 126 px against a 120 px minimum , the text bounds and the loudness at each sound accent. 1. Spec. Before any code the agent writes SPEC.md : size, frame rate, exact duration, codecs and loudness; every on-screen word copied exactly; the palette; a beat sheet with times; and a "done when" list with one checkable line per requirement. 2. Route and build. Each beat goes to the tool that fits it, starting from templates that already render. HyperFrames is the spine where every layer meets on one timeline. 3. Self-check. check delivery.sh measures the file PASS, WARN or FAIL . contact sheet.sh pulls stills at the important moments, and the agent views them and marks every "done when" line met or not met, with evidence. 4. Fix. Worst miss first, render again, up to three rounds. 5. Deliver. final.mp4 and a REPORT.md that says what was checked, how, and what is still open. | The beat needs | Tool | Licence | |---|---|---| | Type, layouts, UI, charts, 2D motion | HyperFrames https://github.com/heygen-com/hyperframes HTML, CSS and GSAP https://github.com/greensock/GSAP to MP4 | Apache-2.0 | | Stylised 3D, particles, camera moves | Three.js https://github.com/mrdoob/three.js inside HyperFrames, seeked by time | MIT | | CAD models, materials, physics, exploded views | the optional 3D pack the-3d-pack | MIT and Apache-2.0 parts | | Realistic products, materials, soft light | Blender https://www.blender.org , scripted in Python, headless | GPL external tool | | Sound, joins, exact length, loudness, encoding | ffmpeg https://ffmpeg.org | LGPL/GPL external tool | Mixed briefs, recipes for each mix and the architecture in detail: docs/architecture.md https://github.com/qualixar/brief2mp4/blob/main/docs/architecture.md for people, references/pipelines.md https://github.com/qualixar/brief2mp4/blob/main/plugin/skills/brief2mp4/references/pipelines.md for the agent. Example 04, rendered by the 3D pack on a laptop: five parts drop and settle with baked rigid-body physics, open into an exploded view, and the title lands. 8 seconds of 1080p rendered in about 5 seconds; check delivery.sh passes. An optional layer for briefs with 3D products. It turns a CAD or mesh spec into a GLB, applies material presets, bakes rigid-body physics once so every render frame is identical, writes a self-contained HyperFrames project from a short shot JSON, and renders photoreal hero shots through Blender. The skill detects it; without it, 3D beats use the Three.js template. | Component | What it adds | Built on | |---|---|---| | core | models from mesh specs, material presets, physics bakes, GLB optimisation, shot JSON to HyperFrames | three.js https://github.com/mrdoob/three.js , glTF-Transform https://github.com/donmccurdy/glTF-Transform , meshoptimizer https://github.com/zeux/meshoptimizer , Jolt Physics https://github.com/jrouwe/JoltPhysics , Manifold https://github.com/elalish/manifold , trimesh https://github.com/mikedh/trimesh | | cad | exact parametric parts: enclosures, gears, brackets | CadQuery https://github.com/CadQuery/cadquery | | blender | photoreal hero renders on the GPU Metal, OptiX, CUDA or CPU | your installed Blender https://www.blender.org | bash install.sh --with-3d core bash install.sh --with-3d=core,cad core + CadQuery powershell -ExecutionPolicy Bypass -File .\install.ps1 -With3D core,cad The brief does the asking. "Parts fall and settle" becomes a physics bake with a camera that frames the landing zone; "show what's inside" becomes an exploded view; "hero product" becomes a Blender render with a dramatic light rig. The full mapping, the shot JSON and the look rules are in 3d/README-3D.md https://github.com/qualixar/brief2mp4/blob/main/plugin/skills/brief2mp4/3d/README-3D.md . Motion graphics are half of a video. The other half is editing: cutting your screen recording or footage on a timeline, mixing a voiceover over music so the music ducks when you speak, compositing titles, making the thumbnail. The optional edit pack installs the command-line tools of five free, open-source desktop editors, the ArtCraft apps by storytold https://github.com/storytold MIT or Apache-2.0, at your option , so Claude Code or Codex can do that work too, headless, and hand the result to the same checks. | Component | App | Like | The agent uses it for | Tested recipe | |---|---|---|---|---| | film | FilmCraft https://github.com/storytold/filmcraft 0.20.1 | Premiere | cutting clips on a timeline, transitions, titles, export | film timeline.sh | | sound | SoundCraft https://github.com/storytold/soundcraft 0.20.1 | a DAW | voice + music mix, ducking with automation, bounce | sound mix.sh | | effect | EffectCraft https://github.com/storytold/effectcraft 0.24.1 | After Effects | layered, keyframed compositing and titles | effect title.sh | | photo | PhotoCraft https://github.com/storytold/photocraft 0.23.1 | Photoshop | thumbnails, title cards | photo thumbnail.sh | | vector | VectorCraft https://github.com/storytold/vectorcraft 0.24.1 | Illustrator | logos and lower thirds as SVG | vector lower third.sh | bash install.sh --with-edit film + sound bash install.sh --with-edit=film,sound,effect,photo,vector all five, about 420 MB download on macOS powershell -ExecutionPolicy Bypass -File .\install.ps1 -WithEdit film,sound Every download is checked before anything is unpacked: its SHA-256 must match both the release's SHA256SUMS.txt and the hash pinned in this repository, and when gpg is installed the release signature must verify against the pinned signing-key fingerprint. Versions are pinned because these apps are alpha and move fast; the skill tells the agent to look up each app's real commands