clip

# /clip Cut a video into short clips + reframe. **Subtitles are not this skill's job** — after cutting, the `srt` skill styles them (see the handoff below). ## Entry points - **Explicit timecodes** ("cut 2:00–3:00 of this video") → cut the local file directly: `--video "<file>" --ranges "2:00-3:00,..."`. No STT, no key, no credits. - **AI highlight selection on an STT project** → `--plan` then `--clips` (the flow below). Needs the project's transcript + word timestamps. - **Raw video, "find the good moments"** (no timecodes given) → you can't pick highlights without a transcript, so **ask the user which they want**: - **STT** (proper selection, uses credits): run the `srt` skill's STT first to create the project, then clip it with `--plan`/`--clips`. - **Free** (no STT): the user gives the timecodes and you cut them with `--video --ranges`. Proceed with their choice — don't run STT (which bills credits) without asking. ## Core rules - **Only the worker sees the raw key** — never open, echo, or pass it as an argument. - **The key gate applies only to `--project`/`--plan`/`--clips`.** `--video --ranges` and `--sidecars` are fully offline — never run a key check/registration for them. - **Run in the background** — encoding takes time. - This skill shares the dubbing skill's libraries: the `dubbing` folder must be installed next to `clip`. ## Flow **Phase 1 — plan.** `node scripts/clip.mjs --project <seq> --plan` prints the summary's section map (topic guide) plus t...