shipreel

The original was a prompt and a set of assets: it told an agent how to make one landscape video. This is the pipeline built around that idea.

It reads a project the way a person would: package metadata, README, routes, git history, then boots the dev server and captures the real interface with headless Chrome rather than inventing screenshots. It writes an HTML composition, renders it, and audits the result: duration and frame size, an audio track that is not silent, loudness mastered to -14 LUFS, the poster baked into frame 0 so every platform's thumbnail is the frame you chose, on-screen text large enough to read on a phone and held long enough to read at all, and WCAG contrast on every line. A failed check names itself and says why.

Delivery is the other half. One plan reflows across five frame sizes, and 26 platform presets each carry that service's safe zone, caption mode, duration window and size budget, taken from the platform's own documentation, so an export is ready to upload rather than ready to fix. Every on-screen claim is cited to a file and quote in the repository, so a video cannot say something the project cannot back up.

Since 0.3.0 it makes the rest of a launch too. It reads a project once into a dossier (name, install line, the palette and fonts its own CSS declares, highlights, git story, verified claims, the frames its video produced) and renders the launch images from it: a link preview, an X image, a GitHub social preview, a Product Hunt gallery and a LinkedIn carousel, in the project's own brand and showing its real screens. Each image is checked the way the video is, for exact size, file budget, legibility, safe margins, contrast and claims, and the launch copy is checked against each platform's limits before it is posted.

The recurring work is where it earns its place: release videos built from a git tag and its notes, before/after preview clips for the pages a pull request changes, and a GitHub Action that does both with nothing but the workflow token.

It is tested the way a renderer has to be: 297 tests, golden reference frames to catch a render drifting, and a nightly job that renders a real composition against the current Hyperframes so an upstream break surfaces within a day rather than when a video is needed.

It is free and open source under MIT, and installs with one line: npx @irvinosazee/shipreel skill install. Rendering runs entirely on your own machine, with no account, no service to pay for, and nothing uploaded anywhere. It briefly sold as a paid, private tool; opening it up was the better trade: a tool that reads your private repository should be one you can read too.