HOW TO USE

Use Cuerex as an AI video editing pipeline

Cuerex is a Claude Code plugin that turns a source video into structured editing data and then renders the finished MP4 with Remotion. Run the slash commands in order, inspect the generated data, and rerun only the stages that need changes.

INPUT Start with source video

Give Cuerex a talking-head video, format, preset, language, and editing mode.

DATA Generate reviewable edit data

Cuts, captions, images, clips, sound effects, and output settings are stored as TypeScript data.

OUTPUT Render versioned MP4 files

Export to 16:9, 9:16, or 1:1 without overwriting previous render versions.

QUICKSTART

Run the skills in order

Each command writes data into the generated Remotion project. The source video is not modified.

01 /cuerex-init

Initialize the project

Answer questions about preset, project name, source path, language, diarization, format, and edit mode.

Creates project-config.json and copies the Remotion template.
02 /cuerex-transcribe

Transcribe the source

Runs Whisper large-v3 and optionally diarization to create speech segments with timestamps.

Writes transcript.json.
03 /cuerex-transcript-fix

Normalize wording

Uses dictionary and LLM passes to fix names, notation, mistakes, and repeated wording.

Writes transcript_fixed.json and grows typo_dict.json.
04 /cuerex-cut

Choose the cut structure

Combines VAD and LLM reasoning to keep natural pauses while removing unwanted sections.

Writes src/data/cutData.ts.
05 /cuerex-subtitles

Generate captions and scene titles

Splits text, chooses telop templates, and assigns animations on the edited timeline.

Writes telopData.ts and segmentTitleData.ts.
06 /cuerex-image-gen

Prepare visual inserts

Finds moments where diagrams, screenshots, thumbnails, or explanatory visuals help the edit.

Writes insertImageData.ts and public/images/*.
07 /cuerex-clip-gen

Add motion clips when useful

Optional step: author HTML/CSS/JS motion graphics and render them with HeyGen HyperFrames.

Writes insertClipData.ts and public/clips/*.
08 /cuerex-se

Place sound effects

Maps scene changes, caption reveals, and key beats to sound-effect timing.

Writes src/data/seData.ts.
09 /cuerex-render

Preview or render

Open Remotion Studio for review or render the final video.

Creates out/vN/final_vN.mp4 with data snapshots.

FEATURES

Use the optional features when the edit needs them

Cuerex keeps the renderer shared and moves project-specific decisions into data, presets, and edit modes.

PRESETS

Format-specific defaults

Use biz-youtube, insta-reels, or square-feed presets to adapt captions, pacing, layout, and safe areas.

FORMATS

16:9, 9:16, and 1:1

Switch output format through project-config.json and regenerate from the same editing data.

HYPERFRAMES

Motion clips

Use /cuerex-clip-gen only where motion improves understanding, such as diagrams, intros, or process explainers.

EDIT MODES

Solo or compose

Use solo for one full-frame source, or compose for multi-source layouts such as screen capture, PiP, interview, or dual camera.

EDITOR LOOP

Review and edit ops

Review in cuerex-editor, write timestamped instructions, dry-run edit ops, then apply only the approved data changes.

VERSIONING

Safe renders

Each render goes to out/vN with the MP4 and the data snapshot used for that version.

PRICING NOTE

AI agents and editing tools are separate

Claude Code, Codex, and similar AI agents are cloud-based external tools. If you already have access to those tools, Cuerex itself can be used without an additional fee. The AI Agent Plus editing tool is not free.