{"slug":"alemtuzlak-produce-video","name":"produce-video","description":"Use when the user wants to turn a raw talking-head / screen-share recording into a finished, edited, annotated video plus a full content package. Removes silences, flags mistakes for the user to cut, transcribes, adds transcript-synced overlays (code, on-screen code highlights, word highlights, lists, comparisons, diagrams, section labels, punch-in zooms), renders with original audio, then generates blog/socials/YouTube content. Triggers on \"produce a video\", \"edit my video\", \"annotate my recording\", \"/produce-video\".","long_description":"---\nname: produce-video\ndescription: Use when the user wants to turn a raw talking-head / screen-share recording into a finished, edited, annotated video plus a full content package. Removes silences, flags mistakes for the user to cut, transcribes, adds transcript-synced overlays (code, on-screen code highlights, word highlights, lists, comparisons, diagrams, section labels, punch-in zooms), renders with original audio, then generates blog/socials/YouTube content. Triggers on \"produce a video\", \"edit my video\", \"annotate my recording\", \"/produce-video\".\n---\n\n# Produce Video\n\nTake a recording the user provides and turn it into a finished video. The recording is the spine and drives the timeline; this skill edits (silence + chosen mistakes/pacing) and augments (overlays), then renders and generates launch content. It does NOT author a synthetic video — for PR-driven synthetic promos use `hyperframes-video` instead.\n\n**Quality principle (non-negotiable): every footage step preserves the original quality.** Never let a tool re-encode the footage at low quality. De-silence and cuts run at near-lossless CRF 12 from the original (auto-editor is used only to DETECT silence, never to encode — its default crushes footage to ~0.6 Mbps), and the render runs at CRF 12. CRF gives small files for static screencasts; that is full quality, not loss.\n\n## Relation to other skills (delegate, don't re-derive)\n- **`/transcribe-video`** — all transcription (returns word-level `transcript.words.json`). Invoke it; do not transcribe by hand.\n- **`hyperframes`** — composition authoring rules (Visual Identity Gate, Layout Before Animation, timeline contract, video/overlay layering). **Invoke before writing/mounting any composition HTML.**\n- **`hyperframes-cli`** — every `npx hyperframes` command (init, lint, inspect, preview, render).\n- **`gsap`** — GSAP timeline/easing patterns for overlays.\n- **`youtube-copy`** — YouTube title/description/tags/chapters (P6).\n- **`blog-post`** — the blog post (P6).\n- **`social-copy`** — X/Bluesky/LinkedIn/Reddit copy (P6).\n\n## Bundled assets\n- `scripts/desilence.mjs` — auto-editor silence removal + before/after duration.\n- `scripts/extract-frame.mjs` — single-frame grab (framing detection + on-screen highlight).\n- `scripts/bake-cuts.mjs` — ffmpeg trim/concat cutter (dense keyframes) used in P2.\n- `templates/overlays/*.html` — 9 overlay sub-composition templates (filled per instance; sub-comps are standalone HTML docs in the installed CLI — read each file's header comment).\n- `templates/project/{DESIGN.md,styles.css}` — Visual Identity Gate + brand `var(--brand-*)` tokens the overlays consume.\n- `references/` — `mistake-detection.md`, `overlay-triggers.md`, `framing-safe-zones.md`, `frame-analysis.md`.\n- **P6 content generation is delegated to the `youtube-copy`, `blog-post`, and `social-copy` skills** (no vendored LLM script).\n\n## Gates (non-negotiable)\n1. **P2 mistake review is VISUAL, never terminal** — whenever ≥1 flag exists, the agent ALWAYS builds the hyperframes marker preview (markers on the video at each flagged span) and launches it, so the user decides by *watching*. Do NOT present the flags as a terminal table/question for the user to decide from, and do NOT make the preview optional or ask \"want me to show you?\" — just build it and open it. A short terminal summary of the flags is fine, but the decision surface is the preview. Never auto-apply a cut/ramp.\n2. **P4 overlay plan approval** — present the timestamped overlay table; no build until approved.\n3. **Preview is always agent-launched** — for both the P2 review and the P5 review, the agent starts `npx hyperframes preview` and opens the browser tab itself. NEVER ask the user to run preview or open a URL, and NEVER substitute a terminal-only summary for the live preview.\n4. **Explicit-render HARD-GATE** — render runs ONLY on an explicit user render command (\"render\", \"ship it\"). After a render, edit requests return to the preview loop and do NOT re-render until the user explicitly says so again. Every render needs its own fresh command. This overrides any \"use sane defaults / non-interactive / just ship it\" phrasing.\n\n\"Use sane defaults\" / \"don't ask questions\" skips the *configuration questions* (P0) and the iteration prompting — it NEVER skips the approval gates, the agent-launched preview, or the explicit-render gate.\n\n## Process\n\n### Preflight — check dependencies & skills (run FIRST, before P0)\nVerify the environment before doing any work; warn the user about anything missing and how to fix it.\n- **auto-editor** (required for P1 de-silence): run `auto-editor --version`. If it is not installed, STOP and tell the user: *\"auto-editor is not installed - install it with `pipx install auto-editor` (or `pip install auto-editor`), then re-run.\"* Do not attempt P1 without it.\n- **ffmpeg / ffprobe** (REQUIRED — P2 cuts, P4 frame analysis, P5 render, audio): run `ffmpeg -version`. If missing, STOP and tell the user to install ffmpeg and add it to PATH. The pipeline cannot run without it.\n- **Docker** (for `/transcribe-video`): `docker info`. Warn if the daemon is down (start Docker Desktop).\n- **Node >= 22**: `node --version`. Warn if older.\n- **Required skills** — confirm these are available (try to invoke / check the skill list); warn for any missing and which phase it blocks:\n - `transcribe-video` (P2/P3 transcription), `hyperframes` + `hyperframes-cli` + `gsap` (P2/P4/P5 composition & render), `youtube-copy` + `social-copy` (P6). `blog-post` only if the user opts into a blog (P6, optional).\n- Summarize the preflight result in one short block (what's present, what's missing). Only proceed past a missing **required** dependency/skill if the user explicitly says to continue without it (and note the degraded result).\n\n### P0 — Input & configuration\n- Input: path to the raw recording (required).\n- Optional: a repo/files for real code grounding; visual style/brand (else run the `hyperframes` Visual Identity Gate — detect from the repo, else ask 3 style questions; write `templates/project/DESIGN.md` + brand values into `styles.css`); overlay **density** (sparse / balanced / rich).\n- **Single output folder (``):** everything this skill produces lives under ONE folder, default `/-produced/` (override with a user-supplied path). Create it now. Final structure:\n ```\n /\n final.mp4 # rendered video (P5)\n hyperframes/ # the HyperFrames project: index.html, styles.css, DESIGN.md, compositions/, renders/ (P4–P5)\n transcript.txt # final edited transcript (P3 / P6)\n transcript.srt\n transcript.words.json\n youtube.md # P6\n socials.md # P6\n blog.md # P6\n .work/ # intermediates: 01_desilenced.mp4, 02_edit_N.mp4, frames/ (prunable in P7)\n ```\n All subsequent phases write inside `` — never scatter outputs elsewhere. `` below = `/.work`.\n\n### P1 — De-silence (lossless)\n```\nnode scripts/desilence.mjs --out /01_desilenced.mp4 --margin 0.3s\n```\n`desilence.mjs` uses auto-editor ONLY to detect the silent ranges (`--export v3`), then cuts the ORIGINAL with ffmpeg at near-lossless CRF 12, keeping the original audio. **Do NOT let auto-editor encode the output** — its default re-encode crushes the footage to ~0.6 Mbps and permanently blurs it (faces especially); no downstream bitrate can recover that. Report before/after duration and seconds removed. This becomes the working copy.\n\n### P2 — Mistake & pacing review loop (approval gate)\n1. Transcribe the working copy: invoke `/transcribe-video` on `/01_desilenced.mp4` with `--out ` → working transcript (intermediate; superseded by the P3 final transcript).\n2. Detect flags per `references/mistake-detection.md` (cuts + speed-ramps), snapped to word boundaries.\n3. **Always (whenever ≥1 flag exists) build the visual review.** Scaffold a lightweight hyperframes project with the de-silenced video as the base track; place visually-distinct temporary markers ON THE VIDEO at each flagged span (cut = red strike, ramp = amber fast-forward, each labeled with the excerpt + its index). **Agent starts `npx hyperframes preview` and opens the browser itself** (per `references/framing-safe-zones.md`). This is the decision surface — never replace it with a terminal table. A one-line terminal note (\"3 flags marked in the preview — review and tell me which to cut/ramp/keep\") is the most the terminal should carry.\n4. The user watches the marked preview and picks per span: cut / speed-ramp (factor, default ~1.5–2×) / leave / add their own ranges.\n5. Bake selections → `/02_edit_N.mp4`, then re-preview:\n - **Cuts:** use `node scripts/bake-cuts.mjs --out /02_edit_N.mp4 --cut s,e --cut s,e …` (ffmpeg trim/concat at near-lossless CRF 12 by default — trims video+audio identically in one pass). **Do NOT use auto-editor `--cut-out` for the mistake cuts** — its variadic arg mis-assigns the last range as a positional input, it re-encodes lossily, and a select-filter approach desyncs audio.\n - **Speed-ramps:** auto-editor `--set-speed-for-range speed,s,e` (pitch preserved); pass ONE range per invocation, or place `--set-speed-for-range` last on the command line, to dodge the same variadic-arg pitfall.\n - All cut/ramp timestamps are on the **de-silenced** timeline (the transcript the flags came from). Apply cuts and ramps in the same round against that timeline.\n6. Loop until the user says \"done\". Drift guard: after ~10 rounds offer to reset to an earlier intermediate. Final artifact: `/final_cut.mp4`.\n\nCuts and ramps are baked into the footage HERE (before P3) so the final transcript's word timestamps match the edited timeline.\n\n### P3 — Final transcription\nInvoke `/transcribe-video` on `/final_cut.mp4` with `--out ` so `transcript.txt` / `transcript.srt` / `transcript.words.json` land at the top of the output folder. This word-timestamped transcript is the sync source for all overlays (P4) and the input to content generation (P6).\n\n### P4 — Overlay design & build (approval gate)\n1. **Framing detection** (`references/framing-safe-zones.md`): sample frames with `extract-frame.mjs`, classify phases, confirm phases + safe zones with the user.\n2. **Overlay-trigger detection** (`references/overlay-triggers.md`): scan the word-timestamped transcript → overlay plan rows `{start, est_duration, type, content, safe_zone, why}`. For on-screen code, use `references/frame-analysis.md` (extract frame → locate → normalized box → stability guard). For code cards, repo-if-available-else-synthesize (flag synthesized).\n3. **Self-improvement pass** (≥2 iterations): honor density, enforce gaps + dwell minimums, validate every overlay against the active phase's safe zone.\n4. **Approval gate:** present the timestamped table; user edits/removes/retimes/adds. Synthesized code shown for verification. No build until approved.\n5. **Build** (invoke `hyperframes` + `gsap` first):\n - `npx hyperframes init /hyperframes --video /.work/final_cut.mp4` (the project lives at `/hyperframes`; base: video track 0 `muted playsinline`; audio on a separate track at volume 1 so the voice plays). **Read the generated `index.html` to learn this CLI version's sub-composition include syntax.**\n - Copy `templates/project/styles.css` (with the confirmed brand values) into `/hyperframes`.\n - For each approved row: instantiate the matching `templates/overlays/*.html`, give it a unique composition id + `data-composition-id`, fill its `{{tokens}}`, set `data-start` = the transcript timestamp and `data-duration` = the dwell, mount it above the video. Punch-in zooms scale the video's WRAPPER div (never the `