levantolabs / sagecut-release

# SageCut
House-standard QA for Remotion videos, in your brand, with every frame checked by Sage.
SageCut is available as a Claude Code plugin and a standalone skill. You build your video with Remotion and Claude. SageCut then:
1. measures every frame in code (text size, blank frames, frozen frames, off-brand colours, delivery spec),
2. has the Sage decision model read every frame and answer yes/no questions,
3. sends only the frames it selects to the critics,
4. opens a frame itself only when Sage and a measurement disagree.
It ships with a set of house rules (a quality floor) and reads your brand file for everything above that floor. If you have no brand, it helps you riff on a style.
SageCut does not change your render time. It makes the review step faster and cheaper.
## Install
### Standalone skill via skills.sh
View SageCut on skills.sh.
Run this from your Remotion project:
 [code] 
Add `-g` to install for all your Claude Code projects. Then ask Claude Code: "Use SageCut to review my Remotion video at out/video.mp4."
The skill includes the CLI, OCR runtime and language data, question banks, templates, and QA references. Setup and savings reporting run through the skill; this install does not register plugin hooks. The full workflow and critic cost accounting require Claude Code. The Sage API key requirement below applies to full frame review; `gate --no-sage` runs local measurements only.
The standalone skill lives in `.agents/skills/sagecut`. The `start` and `qa` components under `skills/` belong to the Claude plugin and are hidden from normal skills CLI discovery.
### Claude Code plugin
In Claude Code, run two commands:
 [code] 
Or one command (Claude Code 2.1.275 or later):
 [code] 
## First run with the plugin
Type this in Claude Code:
 [code] 
You get the SageCut start screen, a short explainer and a check of your Sage key. Then: "Begin your video work now...". There is no menu and no test video.
At the start of your first video, SageCut asks for your brand (your website, a brand kit folder, five questions, or a riff on something you like). After that, the `qa` skill starts by itself when you render, review or deliver Remotion work.
## Savings after every video
At the end of every video, SageCut shows what it saved:
 [code] 
SageCut's side is measured: the Sage cost (text and image tokens at your plan's rate), the critics' cost and the QA time. The Opus side is an estimate: $0.101 and 8.6 s per frame viewed, the rate of the 15 Opus 5.5 critics on Levanto's reference build (1,009 frame views (358 distinct frames), $101.96, 2.41 h). `sagecut savings show` gives the totals.
## Requirements
- Claude Code.
- Node 18 or later.
- A Remotion 4 project. If you have none, SageCut can make one with `npx create-video@latest` at the start of your first video.
- A Sage API key from levanto.ai. Put it in your project's `.env` file as `SAGE_API_KEY=...`, or in `~/.sagecut/.env` to use one key in all your projects. Never paste it in the chat.
SageCut n