An Agent Skill · for any AI agent

Your agent directs the film. Not just the clips.

A brief or a reference video in. A checked, finished short film out — casting, voice, word-level captions, motion and mix on one timeline.

The whole production chain: generation, speech timing, composition and a delivery check. Not only the composition step.

npx skills add EmergenAI/video-recut -g
SABCD?! DIRECTOR SCENE 07TAKE12ROLLDIRCAM A Action! talking head podcast street interview ranking short drama check.mjs plan.json ✓ delivered explainer.mp4.report.json

One take

Watch one film go from brief to delivery.

A brief arrives. Words, shots, captions and sound land on one timeline. The cut plays, the stamp lands on its word, and the checks pass before anything ships.

BRIEF“A 24-second launch film for our cold-brew can.” directing… TIMELINEtimeline.json 0s 1s 2s 3s 4s WORDS PICTURE CAPTION SOUND EVENTS By Friday every one was gone shot1 shot2 shot3 By Friday, every one was gone. stamp find("s4", "gone").start → 2.75s SOLD OUT assembling… By Friday, every one was gone. ✓ delivered plan shots sound length launch.mp4.report.json delivery checks · check.mjs vs plan.json

The gap

Generating a clip is easy. Getting a film is the work.

If you have tried to make a short video from generated material, you have probably hit these. The right-hand column shows what the Skill takes care of.

Where it breaks
What Video Recut owns
The same character has a different face in the second shot.

One set of reference images goes into every request for that character, and the chain of references is tracked.

guides/3-materials/reference-chains.md
Reword one line and every caption and reveal after it is off.

Events are bound to the spoken word, not to a typed second. New words or a new take move them along.

timing/timeline.json · guides/4-compose/timing.md
Fixing one word means paying for generation again.

Pictures, captions and motion live in an HTML page. Changing them costs a re-render, which costs only time. Generated material is reused through the manifest.

manifest.json · bibei.mjs status
The voice drifts from one line to the next.

Voice is cast like a role: chosen once, sampled, then kept for every segment the speaker performs.

guides/3-materials/voices.md
Nobody tells you whether it is good enough before you ship it.

The final render is checked against the plan, and the agent watches and listens to the encoded file before calling it done.

plan.json · scripts/check.mjs

Compared with

The two ways people usually do this today.

Video generator + editing appAgent that writes scripts & promptsVideo Recut
What you getClips. You assemble them.A script and prompts. You generate and cut.A rendered film that passed its checks, plus the editable sources
Where a reveal or cut sitsAt a second on the trackNot decidedOn the word it answers
Cost of a changeRegenerate, or re-edit by handRegenerateEdit the page and re-render. Paid material is reused
Who owns the visual systemThe model, then your timelineNo oneAn HTML composition page you can read and edit
Before deliveryYour eyesNothingplan.json checks, then the agent reviews the final file

Video Recut does not replace the generator. It drives one: images, video, voice and word timing all run on your own Bibei account.

Ways in

Start from wherever you are.

01 / BRIEF

From an idea

"A 30-second launch video for our cold-brew can."

The agent writes the Brief, makes a creative plan you can approve, and only then asks to spend.

How briefs work →
02 / REFERENCE

From a video you like

"Like this one, but with our product and a different host."

It reads the reference end to end — why each cut, picture and sound is there — then rebuilds that for your words.

How adapting works →
03 / FOOTAGE

From what you shot

"Here are my takes from yesterday."

Each file gets a job: a reference, a performance to keep, a standalone picture, or a sound source.

How footage is used →

How it works

Six stages, each leaving a file you can open.

Nothing lives only in a chat. Every stage writes its result to disk, so another session — or you — can pick up the production where it stopped.

Images & video

bibei.mjs
prompts/
generated/
manifest.json

Speech

Bibei speech synthesis
composition/audio/

Word timing

bibei.mjs align
timeline.mjs build
timeline.json
timeline.js

Media prep

FFmpeg / ffprobe
processed files beside the originals

Compose & render

HyperFrames via render.mjs
index.html
renders/

Delivery check

check.mjs vs plan.json
*.report.json

Worked example

A "sold out" stamp lands on the word gone.

In an editor, the stamp sits at a fixed second, and drifts the moment the line changes. Here the page asks the timeline when the word is spoken, and puts the stamp there.

// composition/index.html
var MOMENTS = {
  soldOut: find("s4", "gone").start
};
tl.from("#stamp",
  { scale: 1.9, opacity: 0, duration: 0.28 },
  MOMENTS.soldOut);

Reword the line. The stamp moves with it.

Worked example

A film that misses its plan does not ship.

Every render except a draft runs the delivery checks against plan.json first. If a check fails, nothing renders. If the finished length is off, the file is set aside as .REJECTED. A film is delivered only with its report.

The checks: the plan exists and is complete, every planned shot is on the page, no shot is longer than 15 seconds, every sound is registered with its source, all speech comes from the script, no reference audio slipped in, and the length matches.

Formats

Seven formats it already knows how to direct.

Each format has a playbook: how that kind of video holds attention, and the craft problems that come up in it. Formats can be combined.

Install and prepare

All you need is a Bibei account.

Everything else, including the install itself, can be left to your AI agent: it checks what this computer is missing and installs it. Before a large download or anything that changes your system, it tells you what it is and how big, and waits for your OK.

How to install

Recommended: let your AI agent install it. Copy the sentence below and send it to the AI agent you use (for example Claude Code, Codex or any agent that can run commands on your computer). If your system asks for confirmation during the install, click Yes.

Please install the Video Recut skill for me: check that Node.js 22 or newer is on this computer and install it if it is missing, then run npx -y skills add EmergenAI/video-recut -g -y and tell me when it is done.

Comfortable with a terminal? Run it yourself. The command needs Node.js, so install it first: download the LTS installer from nodejs.org and click through; then open a new terminal and type node -v. A version of v22 or higher means it is ready. Then run:

npx skills add EmergenAI/video-recut -g

The first time, if it asks whether to install the skills tool (Ok to proceed?), type y and press Enter.

Once it is installed, start a new conversation and you are ready.

You bring

A Bibei account with creditsPictures, video, voice and word timing are generated on your own Bibei account and billed in credits. Sign up and top up at bibei.cn. The agent opens the open-platform page and walks you through creating the key.

The agent takes care of

Node.jsWhen the agent installs Video Recut, it checks for Node.js and installs it first, and upgrades it later if it gets too old. If you run the command yourself, install it first as described above.
FFmpegThe audio and video tool. The agent installs it the first time it is needed.
Render dependencies and the render browserThe packages that turn the page into a video, and one pinned browser build. Installed once before the first render, then used for every film.
yt-dlpInstalled only when you give a video link and the reference has to be downloaded first.

What runs on Bibei

Bibei (bibei.cn) is an AI generation platform; Video Recut uses its open platform to generate pictures and sound. Only the items on the left use Bibei credits. Everything else runs on your own computer at no charge.

Done on your computer · no credits

  • Reading the reference, writing the script and plan
  • Cutting and converting media
  • Captions, motion, mix and composition
  • Rendering and delivery checks; a change is a re-render, which costs only time
The Skill itself is free. It pays for no generation, and spends nothing you haven't agreed to. Before anything that uses credits, the agent agrees the account, the work and the budget with you, writes it into the Brief, and stays inside it. The same request is never charged twice.

Hand your agent the director's chair.

npx skills add EmergenAI/video-recut -g

The command needs Node.js, or let your agent install it →