@milenyumai/film-kit-hybrid-smart

Professional smart hybrid cinematic prompt kit for Nano Banana stills and dialogue-aware Veo/Kling video routing.

What It Does

• Writes ILK/SON still prompts for Nano Banana Pro / Google.
• Routes video prompt sections automatically:
  • dialogue / lip-sync -> Veo 3.1
  • no-dialogue action / inserts / atmosphere / silent reactions -> Kling 3.0
• Keeps all routes under one editorial and continuity contract.
• Enforces spatial realism rules for gaze, depth, scale, and compositing realism.

Install

npm i -D @milenyumai/film-kit-hybrid-smart

Init

npx @milenyumai/film-kit-hybrid-smart init
npx @milenyumai/film-kit-hybrid-smart init --aspect 16:9 --nano-size 4K
npx @milenyumai/film-kit-hybrid-smart init --kling-preset balanced
npx @milenyumai/film-kit-hybrid-smart init --overwrite

Generated Runtime

• CLAUDE.md + .claude/CLAUDE.md
• native Claude prompt-engineer subagent
• OpenAI Codex App / Cursor / Copilot / Antigravity surfaces
• .codex/config.toml + .codex/agents/prompt-engineer.toml
• .agents/skills/*/SKILL.md Codex skill mirror with the smart hybrid prompt-structure override
• smart hybrid overrides and route-aware prompt-structure overrides

Contracts

• one file per shot
• shot-plan.json carries project-level voiceCast
• speaking video sections carry machine-readable AUDIO PLAN
• parser-compatible Audio direction: blocks stay available across routes
• per-section route declaration
• app.kling custom storyboard cap: 4
• Kling-routed no-dialogue prompt code blocks start with [CHARACTER / SUBJECT CONSISTENCY]
• Veo/Kling grammar separation is enforced
• hard gate:
  • ILK >= 120
  • SON >= 120
  • VIDEO >= 160
  • coverage still >= 90
  • coverage video >= 110
• spatial realism gate for interacting subjects:
  • eyeline target
  • plane map
  • shared light source
  • contact and depth cues

Best For

• dialogue-heavy scenes with silent coverage
• mixed Veo + Kling productions
• editorial routing by shot section

License

MIT