edit-video-story
Installation
SKILL.md
Edit Video Story
Act as editor, motion designer, colorist, and finishing producer. Preserve source media. Prefer DaVinci Resolve for the primary edit and finish, Remotion for designed motion graphics, and FFmpeg/ffprobe for inspection, transcodes, and objective QC.
Resolve every bundled relative path from the directory containing this SKILL.md; never interpret references/... or scripts/... from the user's project directory.
Required workflow
- Set the delivery contract and route. Resolve the audience, platform, exact or maximum duration, aspect ratio, resolution, frame rate, caption requirement, music rights, tone, deadline, and desired project/source files. When the user has not fixed an editor, apply the autonomous production router to choose DaVinci Resolve, Remotion, or another verified route by expected final quality.
- Inventory the media. Run
scripts/media_inventory.pyon all supplied media. Record duration, frame rate, dimensions, orientation, codecs, audio channels, timecode clues, and technical problems before opening an editor. - Protect the originals. Work from a new project, timeline, and export destination. Never rename, trim, relink, transcode over, or delete source files.
- Find the story. Transcribe dialogue when useful. Mark hook lines, emotional turns, proof, visual variety, clean reactions, and unusable material. Build a paper edit with source file, in/out, role, spoken line, visual, audio treatment, and reason.
- Budget time. Allocate seconds across the story before building the timeline. For a 90-second application video, start with hook 0–8, context 8–25, proof 25–62, reflection 62–78, and close 78–90; adapt to the actual footage and brief.
- Build the radio edit. Make dialogue coherent and emotionally natural before adding b-roll, effects, or music. Remove repetition, filler, and dead air without creating unnatural speech.
- Build the picture edit. Use cutaways to clarify, compress time, hide necessary dialogue edits, and add specificity. Favor motivated straight cuts; use transitions only when they communicate time, place, memory, or a tonal shift.
- Design motion and captions. Establish a small motion system tied to the visual direction. Read typography casting; select titles and captions from the available library for the story's voice rather than defaulting to technical typography. Keep them legible, inside platform-safe zones, and timed to meaning. Load a verified Remotion best-practices skill when one is available for Remotion work.
- Finish sound and color. Prioritize dialogue, control noise and room-tone discontinuities, shape music around speech, and normalize for the destination. Use a color-managed workflow, match shots before applying a look, and avoid a blanket LUT when camera color space is unknown.
- Review in three gates. Review the rough cut for story, picture lock for timing and graphics, and final render for technical and perceptual defects. Continue with best judgment when the user asked for autonomous completion; surface a checkpoint when a subjective fork would substantially change the film.
- Run final QC. Read video-qa.md and the zero-defect gate, run
scripts/video_qc.pyon the exact export, close the defect ledger, and watch the full file from beginning to end with sound.