produce-video
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".
AlemTuzlak · AI review on file
Installation
Read the source and dependencies before running a command. Copying does not install or execute anything.
npx skills add AlemTuzlak/skills --skill produce-videoAbout this skill
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".
Produce Video
Take 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.
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.
Relation to other skills (delegate, don't re-derive)
/transcribe-video— all transcription (returns word-leveltranscript.words.json). Invoke it; do not transcribe by hand.hyperframes— composition authoring rules (Visual Identity Gate, Layout Before Animation, timeline contract, video/overlay layering). Invoke before writing/mounting any composition HTML.hyperframes-cli— everynpx hyperframescommand (init, lint, inspect, preview, render).gsap— GSAP timeline/easing patterns for overlays.youtube-copy— YouTube title/description/tags/chapters (P6).blog-post— the blog post (P6).social-copy— X/Bluesky/LinkedIn/Reddit copy (P6).
Bundled assets
scripts/desilence.mjs— auto-editor silence removal + before/after duration.scripts/extract-frame.mjs— single-frame grab (framing detection + on-screen highlight).scripts/bake-cuts.mjs— ffmpeg trim/concat cutter (dense keyframes) used in P2.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).templates/project/{DESIGN.md,styles.css}— Visual Identity Gate + brandvar(--brand-*)tokens the overlays consume.references/—mistake-detection.md,overlay-triggers.md,framing-safe-zones.md,frame-analysis.md.- P6 content generation is delegated to the
youtube-copy,blog-post, andsocial-copyskills (no vendored LLM script).
Gates (non-negotiable)
- 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.
- P4 overlay plan approval — present the timestamped overlay table; no build until approved.
- Preview is always agent-launched — for both the P2 review and the P5 review, the agent starts
npx hyperframes previewand 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. - 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.
"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.
Process
Preflight — check dependencies & skills (run FIRST, before P0)
Verify the environment before doing any work; warn the user about anything missing and how to fix it.
- 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 withpipx install auto-editor(orpip install auto-editor), then re-run." Do not attempt P1 without it. - 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. - Docker (for
/transcribe-video):docker info. Warn if the daemon is down (start Docker Desktop). - Node >= 22:
node --version. Warn if older. - Required skills — confirm these are available (try to invoke / check the skill list); warn for any missing and which phase it blocks:
transcribe-video(P2/P3 transcription),hyperframes+hyperframes-cli+gsap(P2/P4/P5 composition & render),youtube-copy+social-copy(P6).blog-postonly if the user opts into a blog (P6, optional).
- 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).
P0 — Input & configuration
- Input: path to the raw recording (required).
- Optional: a repo/files for real code grounding; visual style/brand (else run the
hyperframesVisual Identity Gate — detect