@milenyumai/film-kit 2.3.4 → 2.3.6

package/packages/studio/content/skills/storyboard-reference/SKILL.md

@@ -13,7 +13,7 @@ Use this skill when the user provides:
 - a video brief or scenario text
 - optional external storyboard guide images
 
-The output is a production workflow, not only a video prompt. First create one reusable GPT Image 2 character sheet prompt per reference character. Then create one GPT Image 2 storyboard prompt per `SHOTNN.md`. The generated shot storyboard is the staging reference for the final video model prompt.
+The output is a production workflow, not only a video prompt. First create one reusable GPT Image 2 character sheet prompt per reference character. Then create one GPT Image 2 storyboard prompt per `SHOTNN.md`. If no external storyboard image is supplied, this generated prompt is the mandatory storyboard bootstrap step. The generated shot storyboard is the staging reference for the final video model prompt.
 
 ## Reference Prep
 
@@ -36,11 +36,13 @@ For each shot, generate a professional GPT Image 2 storyboard prompt:
 
 - provider: `gpt-image-2`
 - aspect ratio: `16:9`
-- panel budget: 4-6s = 1-2 panels, 7-10s = 2-3 panels, 11-15s = 3-4 panels
-- hard cap: max 4 panels/phases per shot unless the configured project cap is lower
-- split policy: 5+ distinct phases must become separate chained `SHOTNN.md` files
+- storyboard sheet panel budget: default is 12 cinematic panels in one GPT Image 2 storyboard sheet; an explicit storyboard panel hint may request 1-12 panels
+- video phase budget: 4-6s = 1-2 phases, 7-10s = 2-3 phases, 11-15s = 3-4 phases
+- hard cap: max 4 video phases per shot unless the configured project cap is lower
+- split policy: 5+ distinct real video phases, scene changes, or location/action blocks must become separate chained `SHOTNN.md` files; 5-12 storyboard sheet panels alone do not force a split
 - target detail: dense professional storyboard direction, concrete blocking and camera language, no decorative prose
-- storyboard art grammar: black-and-white rough pencil drawings, minimal detail, rapid gesture energy, simple anatomy construction, strong silhouette readability, unfinished previsualization feel
+- storyboard art grammar: white paper 16:9 production storyboard sheet, actual drawings black and white only, rough pencil lines, minimal detail, fast gesture drawing energy, simple anatomy construction, strong silhouette readability, unfinished previsualization feel
+- hard negative style lock: do not create photorealistic cinematic stills, full-color rendered panels, concept art, movie frames, underwater/color-grade panels, 3D render, anime, CGI, or polished illustration
 - annotation grammar: red arrows = body movement, blue arrows = camera movement, green marks = framing/composition, orange marks = lighting direction, purple marks = vocal/emotional emphasis, black text = very short lens notes and panel labels
 - continuity: include previous shot handoff, next shot handoff, shared `visual_world`, screen direction, lighting, and action rhythm
 
@@ -75,9 +77,10 @@ Seedance 2.0:
 - Map character sheet images to `@Image1`, `@Image2`, ... with legacy aliases `@image1`, `@image2`, ...
 - Map the generated shot storyboard to the next image token, for example one character means `@Image2`, two characters means `@Image3`.
 - Character image tokens control identity, face, body proportions, wardrobe, accessories, and visible props.
-- The storyboard token controls composition, blocking, camera direction, timing, action rhythm, and phase order only.
-- Follow generated storyboard panels left-to-right, top-to-bottom. Do not reinterpret the action, pose logic, camera angle, emotional progression, frame variety, or final pose.
-- Treat storyboard arrows, labels, lens notes, and colored marks as planning annotations only; never render them into the video.
+- The storyboard token is the complete visual/action/camera/choreography source and controls composition, blocking, camera direction, timing, action rhythm, framing variety, final pose, and phase order only.
+- Follow all storyboard beats left-to-right, top-to-bottom. Do not reinterpret pose, action, camera angle, emotional progression, framing variety, movement logic, shot order, or final pose.
+- Compress the full 12-beat default storyboard sheet into the requested duration as readable motion snapshots while preserving the duration-aware video phase budget.
+- Treat storyboard arrows, labels, notes, lens notes, page headers, panel borders, and colored marks as planning annotations only; never render them into the video.
 - Use explicit timeline phases when the storyboard has multiple beats.
 - Use `No scene cuts throughout, one continuous shot` only for a true single uninterrupted camera move.
 - For multi-phase storyboard prompts, use only the planned phase transitions and do not add unplanned cuts.
@@ -108,6 +111,7 @@ Each shot file contains:
 - provider reference tokens
 - GPT Image 2 storyboard prompt
 - storyboard interpretation
+- storyboard_creation metadata in `SHOTNN.bundle.json`
 - audio plan
 - prompt bundle for requested models
 - QA verdict
@@ -116,6 +120,7 @@ Generated files:
 
 ```text
 $OUTPUT_DIR/storyboard-reference-plan.json
+$OUTPUT_DIR/storyboard-prompt.md
 $OUTPUT_DIR/reference-prep/CHARACTER-SHEET-*.md
 $OUTPUT_DIR/storyboard-prompts/SHOTNN-GPT-IMAGE-2-STORYBOARD.md
 $OUTPUT_DIR/prompt-bundles/SHOTNN.bundle.json

package/packages/studio/content/workflows/generate-storyboard.md

@@ -33,11 +33,12 @@ description: Generate character sheet prompts, per-shot GPT Image 2 storyboard p
    - exact identity, wardrobe, accessories, and visible props
    - no labels, text, logos, watermarks, alternate designs, or extra characters
 3. Confirm target models: `veo31`, `seedance-2.0`, `kling-3.0`, or a user-provided subset.
-4. Select shot storyboard panel budget:
-   - 4-6 seconds: 1-2 panels/phases
-   - 7-10 seconds: 2-3 panels/phases
-   - 11-15 seconds: 3-4 panels/phases
-   - 5+ distinct phases: split into multiple `SHOTNN.md` files
+4. Select video phase budget and storyboard sheet panel count:
+   - 4-6 seconds: 1-2 video phases
+   - 7-10 seconds: 2-3 video phases
+   - 11-15 seconds: 3-4 video phases
+   - GPT Image 2 storyboard sheet defaults to 12 panels; explicit panel hints may request 1-12 panels
+   - 5+ distinct real video phases, scene changes, or location/action blocks: split into multiple `SHOTNN.md` files
 5. Build `visual_world`:
    - environment
    - lighting
@@ -47,6 +48,7 @@ description: Generate character sheet prompts, per-shot GPT Image 2 storyboard p
 6. Generate one GPT Image 2 storyboard prompt per shot:
    - use character sheets as the only identity source
    - use optional storyboard guide only for composition, blocking, camera, timing, and rhythm
+   - enforce white-paper, black-and-white rough pencil production storyboard artwork; only annotation arrows/marks may use color
    - include previous shot handoff and next shot handoff
    - preserve shared location, lighting, screen direction, action rhythm, and scene continuity
 7. Build model prompt bundle:
@@ -89,8 +91,24 @@ npx @milenyumai/film-kit generate-storyboard \
 - Missing character reference: stop and request a valid reference.
 - Empty brief: stop and request a brief.
 - Public figure / real-person likeness / trademark risk: stop or safely anonymize before prompt generation.
-- 5+ storyboard phases: do not compress into one prompt; split shots.
+- 5+ real video phases: do not compress into one prompt; split shots. 5-12 storyboard sheet panels alone do not force a split.
 - Missing GPT Image 2 character sheet prompt: output is invalid.
 - Missing GPT Image 2 per-shot storyboard prompt: output is invalid.
 - Missing `Avoid` / negative prompt: output is invalid.
 - Kling prompt missing required block structure: output is invalid.
+- Main-shot `ILK FRAME`, `İLK FRAME`, `SON FRAME`, `SHOTNN_START`, `SHOTNN_END`, exact first-frame reuse instructions, or mandatory Start+End transition fields: output is invalid in storyboard-reference mode.
+
+## Required SHOTNN.md Sections
+
+Every storyboard-reference shot file must include:
+
+- `Model Control`
+- `Input Asset Roles`
+- `Reference Asset Requirements`
+- `GPT Image 2 Character Sheet Prompt` or a link to the generated character sheet prompt
+- `GPT Image 2 SHOTNN Storyboard Prompt`
+- `Storyboard Plan`
+- `Audio Plan`
+- `Seedance 2.0 Ready Video Prompt` or model-ready equivalent
+- `Coverage Shots`
+- `QA Verdict`