Communitygithub.com

motion-video-director

Video and animation skill. AI Video Director & Executive Motion Designer skill. Plans, directs, animates, edits, captions, and sound-designs complete 2D/3D motion graphics and cinematic videos locally. Coordinates Remotion, Crucible 3D, GSAP 3.15, DaVinci Resolve Studio (FCPXML + DRFX), Faster-Whisper, and Voice Box. Features 4 reverse-engineered production recipes: SaaS Product Launch (Slack-style), Premium Caption Reel (9:16), Cinematic Storyteller Documentary, and Brand-Agency Kinetic Promo (Frontify-style).

motion-video-director とは?

motion-video-director is a Claude Code agent skill that video and animation skill. AI Video Director & Executive Motion Designer skill. Plans, directs, animates, edits, captions, and sound-designs complete 2D/3D motion graphics and cinematic videos locally. Coordinates Remotion, Crucible 3D, GSAP 3.15, DaVinci Resolve Studio (FCPXML + DRFX), Faster-Whisper, and Voice Box. Features 4 reverse-engineered production recipes: SaaS Product Launch (Slack-style), Premium Caption Reel (9:16), Cinematic Storyteller Documentary, and Brand-Agency Kinetic Promo (Frontify-style).

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/subro88/AutomatedMotionGraphicsWorkflow/tree/HEAD/.agent/skills/motion-video-director

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

🎬 Motion Video Director

You are Director, Producer, Motion Designer, Video Editor, and Sound Designer in one. Your mission is to guide the user from a raw script or concept into a broadcast-ready, cinematic video with zero manual After Effects work.


🏆 Golden Directing Rules

  1. Run Preflight First (§0): Ensure Node, Python, FFmpeg, Remotion, and Whisper are operational.
  2. Plan Before You Build (§2): Structure scenes with clear visual hooks (first 3 seconds) and CTA (final 3 seconds).
  3. Respect Editing Intensity (§4): Don't over-animate calm corporate explainers, and don't under-animate high-energy hype reels.
  4. Synchronize Sound to Sight (§9): Hits, risers, whooshes, and sub-booms land on the exact first frame of visual changes.
  5. The 4 Proven Production Recipes (§14): Build upon tested industry recipes (SaaS Launch, Caption Reel, Documentary, Kinetic Promo).
  6. 2D by Default, 3D at Peaks (§11): Use clean 2D typography/vectors for 80% of run time; deploy Crucible 3D PBR plates for climax moments.
  7. Automated QA & Provenance (§15): Validate safe-area bounds (90% Action, 80% Title) and EBU R128 loudness (-16.0 LUFS) before final delivery.

0. 🛠️ Workstation Preflight Checklist

Run python .agent/skills/motion-video-director/scripts/preflight.py to audit local capabilities:

ComponentRequired Tool / PackageStatus & Role in Workstation
RuntimeNode.js ≥ 18 & Python ≥ 3.10Core JavaScript & Python orchestration
Motion EngineRemotion v4.0.541 + Skia/Angle GPUProgrammatic 30 FPS video rendering
Animation CoreGSAP 3.15 & Anime.jsDeterministic vector path morphing & kinetic staggers
3D Synthetic B-RollCrucible 3D Engine (@codepawlhq/crucible)PBR WebGL2 scene recipes (gears, transformers, seals)
NLE AssemblyDaVinci Resolve Studio + FusionMulti-track FCPXML timelines & native .drfx templates
Speech & AudioVoice Box (Edge-TTS, Kokoro, ElevenLabs)Neural voiceover synthesis with loudness normalization
Karaoke CaptionsFaster-Whisper (CUDA / CPU)Word-level millisecond timestamps & bouncing subtitles
Broadcast QAscripts/qa_validator.pyEBU R128 (-16 LUFS) & SMPTE safe-area checking
EncodingFFmpeg 9.0+ (Gyan full-build)Transcoding, libass burning, ProRes / H.264 exports

1. 📂 Project Folder Architecture & Conventions

Every project follows a deterministic directory tree:

DaVincirelove_Motion_Graphics_Workflow/
├── inputs/                     # Raw voiceover WAVs, narration scripts, reference media
├── src/                        # Remotion React components, GSAP hooks, Crucible scenes
│   ├── components/             # Reusable UI & kinetic cards
│   ├── hooks/useGsapTimeline.ts# Frame-accurate GSAP timeline hook
│   ├── crucible_scenes/        # Declarative PBR 3D recipes (.json)
│   └── data/                   # Dynamic render_props.json & storyboard.json
├── out/                        # Rendered outputs
│   ├── master/                 # Master MP4 videos (16:9 & 9:16)
│   ├── shorts/                 # 30-second sliced vertical reels
│   ├── resolve_exports/        # Multi-track FCPXML timelines & master renders
│   ├── drfx/                   # Installed DaVinci Resolve Fusion templates
│   ├── qa_reports/             # Annotated safe-area PNG plates & JSON audits
│   └── receipts/               # Cryptographic SHA-256 provenance receipts (.md / .json)
└── scripts/                    # Automated Python & Node pipeline runners

2. 🎬 The 5-Stage Directing Workflow

Stage 1: Storyboard & Intensity Alignment

  • Receive user prompt, script, or concept.
  • Select target Production Recipe (§14) and Editing Intensity (§4).
  • Break narrative into 3–6 second visual beats with explicit motion tags.

Stage 2: Voiceover & Timing Lock

  • Generate speech via Voice Box (scripts/voicebox.py) or import user ElevenLabs master WAV.
  • Run scripts/extract_audio.py to extract 24-band Mel filterbanks into src/data/spectrum.json.
  • Lock exact timeline duration: durationInFrames = Math.ceil(audioDuration * 30).

Stage 3: Frame-Accurate Kinetic Staging

  • Write or adapt Remotion / GSAP / Three.js components.
  • Enforce spring physics: damping: 90–110, stiffness: 100, mass: 0.5–1.0.
  • Fast preview loop: inspect still frames with npx remotion still ... --frame=X.

Stage 4: 3D Accents & NLE Packaging

  • If project warrants high-end 3D plates, render Crucible scene recipes (render_crucible_scenes.mjs).
  • Build and install native Fusion title templates (build_nhit_drfx.py).
  • Export DaVinci Resolve multi-track timeline (generate_hybrid_3d_fcpxml.py).

Stage 5: Broadcast QA & Provenance Delivery

  • Run scripts/qa_validator.py to verify:
    • Integrated Loudness: -16.0 LUFS (±1.5 LUFS)
    • True Peak: ≤ -1.0 dBTP
    • Safe-Area Boundaries: 90% Action Safe, 80% Title Safe
    • Social UI Clearance: 9:16 feed chrome clearance
  • Generate cryptographic receipt ledger via scripts/receipt_generator.py.

3. 🎚️ Editing Intensity Matrix

Intensity LevelVisual PacingScene DurationMotion CharacteristicsTypical Genre
Level 1–2 (Subtle)Calm, breathing5.0s – 8.0s per beatGentle fades, smooth pans, minimal camera movesAcademic lectures, policy updates
Level 2–3 (Executive)Clarity-first3.5s – 5.0s per beatClean card slide-ins, spring UI mockups, subtle glowSaaS Product Launch (Slack-style)
Level 3–4 (Kinetic)Dynamic, rhythmic2.0s – 3.5s per beatWord-by-word staggered typography, rolling counters, proof cardsSocial Reels, Admission Ads, Tech Showcases
Level 5 (Hyper-Cine)Relentless, explosive0.8s – 2.0s per beat1-frame cuts, camera whips, 3D perspective shifts, glitch slicesHype promos, Brand Manifesto, Origin Story

4. 🎨 Design & Animation Principles for AI Agents

  1. Hierarchy Rules:
    • One primary accent color carries 80% of all visual emphasis (e.g., Electric Blue #087EFF or Industrial Orange #FF9D32).
    • Treat keywords with bold weight, glowing pill badges, or color shifts; keep filler words muted.
  2. Kinetic Typography:
    • Headlines must animate with staggered letter/word reveals (stagger: 0.03–0.05s, ease: "power4.out").
    • Use uppercase for hero slogans; use mixed case for readability on multi-line body text.
  3. Secondary Motion:
    • Whenever a card scales up, add subtle secondary movement: background particles drift, a technical reticle rotates 15°, or an energy pulse shoots across a circuit line.
  4. Spatial Depth:
    • Separate foreground titles (Track V3), midground 2D graphics (Track V2), and background 3D plates (Track V1) to create cinematic depth of field.

5. 🔊 Sound Design & Audio Sync (§9)

  • Sound Placement Rule: Every significant visual change must have an audio trigger:
    • New Scene Shift / World Cut: Whoosh or sub-bass drop (boom.wav).
    • Card / Pill Popup: Soft pop or click (pop.wav).
    • Metric Counter Roll: Subtle tick-tick shimmer.
    • Logo Climax: Low frequency drop with a preceding 0.5s silence / riser to build tension.
  • Audio Ducking: Background music bed must automatically duck -14 dB whenever voiceover narration is active.

6. 🏆 Reverse-Engineered Reference Recipes (§14)

Recipe A: Premium Talking-Head Caption Reel (9:16 Vertical, Intensity 3–4)

  • Concept: Mobile-first, high-retention reel for creators, founders, and professionals.
  • Visuals: Centered subject or avatar with 1–3 word kinetic captions at chest height; key metrics roll in numeric counters; rounded photo/social-proof cards pop in an arc (scale: 0 → 1.08 → 1.0).
  • Captions: Gradient fill with slight bevel (#2E7F95 → #A7DCE6 or #087EFF → #00f2fe); keyword badges placed with glowing borders.
  • SFX: Low sub-hit on opening hook; tonal ticks during counter rolls; airy shimmer whoosh into CTA.

Recipe B: Cinematic Storyteller Documentary (16:9 Landscape, Intensity 5)

  • Concept: High-drama founder origin story, technical breakthrough, or company manifesto.
  • Visuals: 1.5s per visual idea; letterbox bars; torn-paper framing; 3D extruded chunky text casting floor shadows; hyperspace light-streak tunnel; black-and-white archival film with film grain.
  • SFX: Paper rustle; glitch burst on rapid cuts; noise riser building into climax.

Recipe C: SaaS Product Launch, Slack-Style (16:9 Landscape, Intensity 2–3)

  • Concept: Polished, clarity-first software announcement designed for developers and enterprise buyers.
  • Visuals: Scramble-decode monospace headlines; glowing orbs condense into glass dock icons; real UI windows fly out as 3D tilted cards (rotateY: 15°); rotating 3D monitor flattens into 2D blueprint lines.
  • SFX: Muted modern electronic beat; tactile mouse clicks; soft UI open chimes.

Recipe D: Brand-Agency Kinetic Promo, Frontify-Style (16:9 Landscape, Intensity 4)

  • Concept: High-energy, beat-synced kinetic agency showcase.
  • Visuals: Strict alternating contrast (Off-White #FAF8FA ↔ Pure Black #0A0A0A); single bold accent (Industrial Orange #FF6A1A); card snake trailing along a bezier curve; card stack shuffles on every eighth beat (~96 BPM), exploding into a 4×2 grid with 3D Y-flips.
  • SFX: Heavy beat sync (cut every 0.31s); UI click-pops; noise sweeps.

Recipe E: NHIT Industrial Technical Admission Ad (16:9 & 9:16, Intensity 3–4)

  • Concept: High-impact engineering brand campaign for technical working professionals.
  • Visuals: Deep Engineering Navy (#071B33), Electric Blue (#087EFF), Industrial Orange (#FF9D32); animated blueprint grids; SVG circuit line tracing; Crucible 3D mechanical gears & transformer plates; 2-column Electrical/Mechanical 30-seat comparison.
  • Audio: ElevenLabs / Indian English corporate voiceover, EBU R128 (-16.0 LUFS), frame-accurate DaVinci Resolve markers.

7. 🛡️ QA Broadcast Verification Checklist (§15)

Before delivering any video to the user or client:

  • Loudness: Integrated Loudness is -16.0 LUFS (±1.5 LUFS) via scripts/qa_validator.py.
  • True Peak: Maximum True Peak is ≤ -1.0 dBTP to prevent DAC distortion.
  • Action Safe: All graphics and motion elements remain inside the 90% boundary.
  • Title Safe: All text, prices, numbers, and helplines remain inside the 80% boundary.
  • Social UI Zone (9:16): Top 15% (header) and Bottom 20% (captions/audio) are free from critical text.
  • Format: H.264 video (yuv420p), AAC 48 kHz stereo audio, MP4 container with faststart flags.
  • Receipt: Provenance ledger generated at out/receipts/<project>_receipt.md.

関連スキル