Communitygithub.com

EyalZameret/Dudu-Director-Video-kit

Used by Dudu (AI promo video director) for stage 7. Measures where each clip actually moves, cuts every shot to its action, color grades problem vs solution, and assembles the rough cut with ffmpeg via tools/build_cut.py.

What is Dudu-Director-Video-kit?

Dudu-Director-Video-kit is a Claude Code agent skill that used by Dudu (AI promo video director) for stage 7. Measures where each clip actually moves, cuts every shot to its action, color grades problem vs solution, and assembles the rough cut with ffmpeg via tools/build_cut.py.

Works with~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/EyalZameret/Dudu-Director-Video-kit/tree/HEAD/.claude/skills/dudu-edit

Ask in your favorite AI

Open a new chat with this agent skill pre-loaded.

Documentation

Dudu: the rough cut

Generators return fixed 5 s clips. Played in full they feel slow: in our first cut a reviewer said "the cuts are very slow", and measuring showed only ~30 of 52 seconds had real action.

1. Measure

python tools/motion_report.py project/clips/*.mp4 prints the movement per half second:

  • 0.1-0.5: frozen; 1-3: slow camera move; 3+: action. For moments that the numbers can't see (a small light changing color), crop and tile that area: ffmpeg -i shot10.mp4 -vf "fps=2,crop=360:200:X:Y,tile=5x2" -frames:v 1 detail.png (the ffmpeg that imageio-ffmpeg installed: python -c "import imageio_ffmpeg; print(imageio_ffmpeg.get_ffmpeg_exe())")..

2. Decide the cut

  • Check library/INDEX.md for a reference with the pace the owner wants, and match its numbers (cuts per 10 s, median shot).
  • Pace is a curve, not a constant (see library/study/V5AFQaEbHQU): a calm opening can hold, the problem compresses, the climax fragments to under 1 s, the turn and the CTA breathe.
  • Keep only the seconds with action. Most shots end up 1.5-4 s. The opening and the CTA may stay longer (logo and spoken line need time).
  • Faster cuts in the problem part build tension; let the turn breathe.
  • Cut before any failure (face change, morph). Replace a failed shot with its keyframe still plus a slow zoom.
  • Dialogue may run over the next shot (J/L cuts), so a long line does not force a long shot.

3. Build

Write project/cut.json (see project/cut.example.json) and run python tools/build_cut.py project/cut.json.

  • Grade in the edit: cold for the problem shots, warm from the turn on. Keep grades gentle; do not push blue into the shadows.
  • Output: H.264 [email protected], yuv420p, bt709, 1080p30. If someone sees blue blotches in an old Windows Media Player, it is the player's decoder; check by extracting a frame with ffmpeg and boosting saturation (eq=saturation=4). If the frame is clean, the file is fine.
  • Review the result with python tools/contact_sheet.py project/out/roughcut-vN.mp4 --every 2.5 --cols 6.

4. Next: sound

Lock the picture first, then load dudu-sound (stage 8): one continuous music track, effects and voices, mixed with tools/mix_audio.py. Per-clip generated audio does not join into one track.

Individual skills in this repo

This repo contains 8 individual skills — each has its own dedicated page.

EyalZameret/Dudu-Director-Video-kit

Used by Dudu (AI promo video director) to drive Gemini (Nano Banana images, Veo video), ChatGPT (GPT Image) and Kling (image-to-video) in a Playwright browser the owner logged into. Contains the working click paths, upload and download recipes, and the fixes for every failure we hit.

EyalZameret/Dudu-Director-Video-kit

Used by Dudu (AI promo video director) for stage 6. Picks the animation model with a one-shot A/B test, writes image-to-video motion prompts for Kling (and Veo / Seedance), and reviews every clip with contact sheets and a motion report.

EyalZameret/Dudu-Director-Video-kit

Used by Dudu (AI promo video director) at every gate. Checks script claims against project/product.md, structure and pacing, and reviews images and clips with keep/fix/regenerate decisions into project/qa-notes.md.

EyalZameret/Dudu-Director-Video-kit

Used by Dudu (AI promo video director) for stages 1-2. Interviews the owner for the brief and writes a 12-shot promo script (problem-agitate-solve, about 70/30 problem/solution, minimal dialogue, one CTA) into project/brief.md and project/script.md.

EyalZameret/Dudu-Director-Video-kit

Switch this session to Dudu (דודו), the AI promo video director, until the owner leaves Dudu mode.

EyalZameret/Dudu-Director-Video-kit

Used by Dudu (AI promo video director) after the picture cut. Designs the sound (cue sheet synced to cuts), generates music, effects and voice (Gemini, TTS, recordings, free libraries), and mixes it onto the cut with tools/mix_audio.py into a finished film.

EyalZameret/Dudu-Director-Video-kit

Used by Dudu (AI promo video director) to learn from a reference video link (YouTube and most video sites). Downloads it for private analysis, detects every cut, reviews one frame per shot, writes a structured analysis into library/study/<id>/analysis.md and updates library/INDEX.md, then deletes the video. Use when the owner shares a link and says "learn from this", "study this", "do it like this", or asks for a style taken from an ad.

EyalZameret/Dudu-Director-Video-kit

Used by Dudu (AI promo video director) for stages 3-5. Builds the style and character bible, the 12-shot list, reference sheets, location frames and the 12 keyframe prompts for Gemini / Nano Banana or ChatGPT / GPT Image, and reviews every generated image.

Related Skills