/scene-inventory-extractor-v2

name: scene-inventory-extractor
description: >
  End-to-end production-prep workflow: extracts comprehensive scene inventories from
  narrative writing, extracts continuity inventory and reset-critical state before prompt
  writing, generates all reference images (characters, locations under multiple
  angles/conditions, props), produces start/end/keyframe shot references with
  consistency verification, and then hands off to shot-specifier for per-shot direction,
  model routing, and prompt manifests. Use when analysing stories, scripts, or prose to
  create production-ready scene breakdowns with full visual asset pipelines. Also trigger when
  the user mentions "scene breakdown", "shot list", "character bible", "location bible",
  "continuity inventory", "reference images", "storyboarding", or any request to
  prepare narrative material for AI video generation. This skill expects access to an
  image-generation MCP and vision capabilities.

Scene Inventory Extractor

Systematic workflow for extracting comprehensive scene inventories from narrative source material and preparing every visual asset required for AI video generation. Continuity is a first-class deliverable: extract story-state, dressing-state, and object-state before writing prompts so a crew can reset scenes accurately when production shoots out of order.

Execution Context

This skill is designed for a command-line agent with:

• **nanobanana image generation MCP** (`generate_image`, `edit_image`,

`character_consistency`, and `multi_image_fusion` as needed), with every image call explicitly using `model: gemini-3-pro-image-preview`

• **Vision capabilities** (ability to inspect generated images for consistency)
• **File system access** (structured output directories)

All image generation and verification runs **silently** — no user confirmation gates during generation phases. Halt only on consistency failures that require human judgement. If `gemini-3-pro-image-preview` is unavailable through the nanobanana MCP, or if it cannot accept the reference images or character-consistency images required by the current phase, **STOP** and report the blocker. Do not switch to another image model.

Workflow Overview

| Phase | Name | Output | |-------|------|--------| | 1 | Source Analysis | Annotated reading notes | | 2 | Creative Pillars | Visual aesthetic + storytelling style + **cinematography specification** + **prompt keyword library** | | 3 | Narrative Spine | Structure, themes, turnpoints | | 4 | Character Bible | Character entries with **reference-image specifications** | | 5 | Locations Bible | Location entries with **multi-angle, multi-condition scouting specs** | | 6 | Props Bible | Props with physical descriptions and ref-image specs | | 7 | Scene Inventory | Per-scene breakdowns | | 8 | Continuity Inventory | Character/location/prop state tracking across scenes | | 9 | Shot Lists | Shot tables with full cinematography fields and duration budgets | | 10 | Thematic Image Plan | Key narrative-beat images | | 11 | Reference Image Generation | All character, location, and prop reference images with **video role manifest** | | 12 | Shot-Frame Generation | Start frame, end frame, and key frames per shot | | 13 | Consistency Verification + Handoff | Vision-based QA pass; final scene pack, frame assets, role manifest, and handoff notes for `shot-specifier` |

> **Skill chain:** `scene-inventory-extractor-v2` prepares the scene pack and image > assets. Hand off to `shot-specifier` when per-shot direction, storyboard generation, > and prompt manifests are needed. Hand off to `video-generator` only after prompt files, > frame paths, model routing, and generation strategy fields exist and the goal is to > submit jobs through the Higgsfield MCP. > > **Read order for reference files:** Before starting Phase 2, read > `references/cinematography-specification.md`. Before Phase 8, read > `references/continuity-inventory.md`. Before Phase 11, read > `references/reference-image-guide.md`. The consistency verification procedure in > Phase 13 is defined in `references/consistency-verification.md`. The prompt keyword > library format is defined in `references/prompt-keyword-library.md`. > **Downstream skill:** This skill stops at Phase 13. When full per-shot storyboarding, > detailed actor/camera/lighting direction, model routing, prompt flattening, audio > generation preferences, and asset-pipeline management are required, hand off to the > `shot-specifier` skill. That skill takes the scene inventory and reference images > produced here as its input. When video generation itself is required, use > `video-generator`; this skill does not call Higgsfield directly.

---

Phase 1: Source Analysis

Read the source material twice. First pass: absorb narrative arc, tone, world. Second pass: extract with pen in hand.

First-Pass Questions

• What is the dominant visual mood? Name it.
• Where does the camera naturally want to be? (Observational? Intimate? Surveillance?)
• What objects carry narrative weight?
• What spaces define the world?
• Who moves through this world and how do they move?
• What is the **light** doing? (Time of day, weather, artificial sources)
• What is the **sound** doing? (Ambient beds, punctuations, silence)

---

Phase 2: Creative Pillars

> **Prerequisite:** Read `references/cinematography-specification.md` before this phase.

Extract and name the visual, storytelling, and cinematographic approaches.

2.1 Visual Aesthetic

**Name:** {Evocative 2–4 word title}
**Definition:** {One sentence capturing look and feel}

Specify: Palette (3–5 named colours), Lighting rules, Texture rules, Camera grammar, Warmth rules. See `templates/scene-inventory-template.md` for field structure.

2.2 Storytelling Style

**Name:** {Evocative 2–4 word title}
**Definition:** {One sentence capturing narrative approach}

Specify: Narrative rules, Rhythm rules, Scale rules.

2.3 Cinemat