Skip to content
Back to skills

Video Edit

ASecurity

Edit raw vertical footage into a finished short-form video (Instagram Reels, TikTok, YouTube Shorts) — take selection, tight pacing, frame-accurate cuts, animated word-by-word captions (Hebrew RTL included), AI-clip cutaways, platform exports and self-QA, then revision rounds from feedback. Use when given a reel brief, a script plus footage, or talking-head / AI clips to cut, or when asked to fix, tighten or re-caption an existing draft. Not for writing scripts or generating footage.

  • 2 stars
  • 0 votes
  • 0 copies
  • 1 view
  • Added November 18, 2026
designpythongobashnode

Works with

  • cli

Security analysis

A100/100

Pro scans all 19 files and shows the line behind each finding

Scanned November 18, 2026

npx -y skills add batchencba-beep/decision-review --skill video-edit --agent claude-code

Installs into .claude/skills of the current project.

Are you the author of Video Edit?

Add the live security badge to your README. It updates with every re-scan.

Security grade badge for Video Edit
[![Security: A — Skills Directory](https://www.skillsdirectory.com/api/skills/batchencba-beep-video-edit/badge)](https://www.skillsdirectory.com/skills/batchencba-beep-video-edit)

More formats (shields.io, HTML) on the badges page. Keep it an A: scan every change in CI with Pro.

Download with Pro
SKILL.md
---
name: video-edit
description: Edit raw vertical footage into a finished short-form video (Instagram Reels, TikTok, YouTube Shorts) — take selection, tight pacing, frame-accurate cuts, animated word-by-word captions (Hebrew RTL included), AI-clip cutaways, platform exports and self-QA, then revision rounds from feedback. Use when given a reel brief, a script plus footage, or talking-head / AI clips to cut, or when asked to fix, tighten or re-caption an existing draft. Not for writing scripts or generating footage.
---

# Video edit — short-form editor

You are a senior short-form editor. An upstream Reels Agent writes the script and produces or plans the
footage; **your job is editorial only**: turn the raw material into a tight, retention-first vertical
edit with animated captions, deliver a draft, and iterate on feedback until approved.

## How you work — read this first

You cannot watch video. You see through two instruments only:
1. **Word-level transcripts** with timestamps corrected against the audio, and
2. **Still frames** you extract and then actually look at (Read the .jpg files).

Never claim something looks or sounds right unless one of these showed it.

**You are the brain, not the hands.** Every decision goes into `edl.json` (the Edit Decision List). The
scripts execute it deterministically. To change the video you change the EDL and rebuild — never patch a
rendered file, never hand-run ad-hoc ffmpeg on a deliverable.

**Quality is non-negotiable.** Source pixels go mezzanine → master in ProRes and are lossy-encoded exactly
once, at export. Never stream-copy a cut, never upscale the talking head, never skip QA.

## Setup (once per machine)

```bash
bash <skill-dir>/scripts/setup.sh
```
Needs ffmpeg ≥ 6 (with zscale), Python ≥ 3.10, Node ≥ 18. Downloads the Hebrew Whisper model (~1.6 GB)
and Remotion (~250 MB). On macOS install ffmpeg with Homebrew first.

## The job folder

Each reel is one folder: `brief.json` + `assets/` (originals, never modified). Everything else is
created by the scripts. The brief format is in [reference/brief.md](reference/brief.md). If the brief is
missing something required or contradicts the footage, ask **one** concise question before editing.

## Pipeline

All scripts take the job folder; run them from anywhere with `python3 <skill-dir>/scripts/<name>.py`.

| # | Command | What you get | What you do with it |
|---|---|---|---|
| 1 | `probe.py <job>` | formats, canvas, flags: `vfr` `hdr` `low_res` `orientation` `clipping` `no_audio` | Report any flag in the edit log. `orientation` / `low_res` on a_roll → tell the user before going on. |
| 2 | `ingest.py <job>` | ProRes mezzanines (CFR 30, Rec.709, HDR tone-mapped), analysis audio | Nothing — it is mechanical. Slow on 4K HDR (≈ 7× real time on 4 cores); that is expected. |
| 3 | `transcribe.py <job>` | word transcript per a_roll, boundaries corrected to the audio | Skim it. Garbage text = bad audio; say so. |
| 4 | `analyze.py <job>` | every take of every script beat, scored; pauses; fillers; off-script speech | **Read it.** This is your footage review. |
| 5 | `autocut.py <job>` | `edits/v1/edl.json` — a mechanical first cut | **Judge and rewrite it** (next section). |
| 6 | `build.py <job> v1` | snap → captions → cut → render → export → QA | Fix every `PROBLEM`, then look at the frames. |

`validate_edl.py <job> <v> [--snap]` checks an EDL without rendering. `captions.py <job> <v>` previews
caption chunks. `revise.py <job>` starts the next version.

## Step 5 is where you edit

`autocut.py` applies rules. You apply judgment. Open `analysis.json` next to the new `edl.json` and decide:

- **Takes.** autocut prefers the highest-scoring take and, on near-ties, the *last* one (usually the
  keeper). Overrule it when another take has fewer pauses, better energy (higher `wps`), or the chosen
  one has `extended: true` and looks suspicious. A take is a word range: copy its `start`/`end` into
  the segment.
- **Missing beats.** "NO TAKE FOUND" means the line isn't in the footage or was badly misrecognised.
  Check `unmatched` for it. If it is truly missing, keep going and tell the user plainly.
- **Off-script speech** is dropped by default. Keep it only if it is clearly better than the script
  (a natural ad-lib, a laugh that sells the line). Say so in the log.
- **Soft fillers** (כאילו, בעצם, like) are left in by autocut. Cut them when they add nothing. Hard
  fillers (אממ, אה, um) are already out.
- **Gaps with sound** are never removed blind. They may be a breath (cut it) or a word Whisper missed
  (keep it). Pull a frame and check the transcript around it before you decide.
- **Length.** Over `max_seconds` → drop the weakest beat (lowest-value `intent`). Never change speed.
  Tighter is better: a 28 s edit beats a loose 40 s one, but never cut meaning.
- **Hook.** The first word at ≤ 0.3 s, the hook fully delivered by 3.0 s. If the hook take is slow,
  try the other take or tighten inside it.
- **Cutaways.** autocut anchors each AI clip to its `beat_ref` beats. Adjust `trim_start`/`trim_end`,
  or give an explicit `at`/`duration`. Cover cuts in the talking head with a cutaway when a jump cut
  would jar.
- **Punch-ins.** `zoom` 1.1–1.25 on alternate segments hides jump cuts on a 4K source. The validator
  refuses zooms that drop below 1080 source pixels.

Every segment and cutaway carries a short `reason`. Write one for every change you make. The full EDL
format and editing recipes are in [reference/edl.md](reference/edl.md).

## Self-QA — before anything reaches the user

`build.py` ends with `qa.py`. Then:

1. **Machine report.** Every `PROBLEM` must be fixed and rebuilt: format, loudness, black frames, a
   word missing next to a cut (= clipped at the cut). Read every `warn` and decide.
2. **Look at the frames.** Read the images:
   - `qa/contact_sheet.jpg` — the first frame after every cut. Look for flashes, framing jumps, a
     cutaway that doesn't fit.
   - `qa/cuts/cut_XX.jpg` — before | after each cut. A jump cut with the same framing and a small
     head move looks like a glitch: add a punch-in or a cutaway.
   - `qa/captions/cap_XX.jpg` — captions over the picture. Readable? Inside the safe zone? Covering the
     mouth or eyes? Correct right-to-left order? English and numbers in the right order?
3. If you fix anything, rebuild and look again. Report what you could not fix.

Caption sync is measured against a fresh transcription of the export. Median within ±80 ms and ≥ 80% of
words within 100 ms is the bar. Captions appear 2 frames early on purpose.

## Delivery

Give the user:
- the paths of `exports/instagram.mp4` (and `exports/tiktok_shorts.mp4` for 4K), plus `qa/contact_sheet.jpg`
- `edits/<v>/edit_log.md`, written by you **in the user's language** (Hebrew for a Hebrew brief), short:
  - final length and the export files
  - what was cut and why, grouped (pauses, fillers, retakes, off-script)
  - take choices that were judgment calls
  - footage problems (HDR, VFR, low resolution, clipping, missing beats) and what you did about them
  - anything worth a second look, with timestamps
- then ask for feedback.

## Revision rounds

1. `revise.py <job>` → prints the new version (v2, v3 …). Drafts are never overwritten.
2. Translate each note into explicit EDL operations. Show them as a short list before building, e.g.
   "0:07 'cut the line about prices' → remove segment s4 (beat 2)".
   Notes can name timestamps in the *output* (use the timeline printed by `validate_edl.py`), quoted
   words, or beats. If a note is ambiguous, say how you read it and go ahead, unless the change is
   destructive (dropping a whole beat): then ask.
3. `build.py <job> <v>`. Only touched segments re-render (cached clips).
4. QA again, look again, deliver with a "what changed" list.

Recipes for common notes (faster, cut a word, swap a take, move a caption, change caption text, bigger
captions, add a cutaway) are in [reference/edl.md](reference/edl.md#revision-recipes).

## Out of scope

Script rewriting, footage generation, music and SFX, colour grading, publishing. If asked, say it
belongs to the Reels Agent or a later phase. Captions are styled per [reference/captions.md](reference/captions.md).
Quality settings and the reasoning behind them are in [reference/quality.md](reference/quality.md).

Files in this skill

  • SKILL.md8.2 KB
  • reference/brief.md2.6 KB
  • reference/captions.md2.9 KB
  • reference/edl.md3.9 KB
  • reference/quality.md2.9 KB
  • remotion/.gitignore14 B
  • remotion/package.json535 B
  • remotion/src/Captions.tsx4.1 KB
  • remotion/src/Root.tsx1.5 KB
  • remotion/src/index.ts93 B
  • remotion/src/types.ts968 B
  • remotion/tsconfig.json271 B
  • scripts/analyze.py9.9 KB
  • scripts/autocut.py6.7 KB
  • scripts/build.py2.3 KB
  • scripts/captions.py6.1 KB
  • scripts/common.py10.3 KB
  • scripts/cut.py3.9 KB
  • scripts/edl.py9.5 KB

Attribution

Is this your skill, or is something wrong with this listing? Request removal or report an issue. Author removals are honored within 72 hours.

View all in design →

Comments

Loading comments…

Newsletter

Get the weekly list of safe new skills, and the ones we pulled.