movie-storyboard

---

name: movie-storyboard description: This prompt instructs an AI to produce a visually cohesive, 12-frame cinematic neo-noir storyboard featuring a detective duo investigating a missing treasure in a smoky, high-contrast urban setting. It specifies consistent character faces, outfits, and atmosphere across all frames, with each image representing a distinct story beat that escalates tension through emotional highs and lows before landing on a twist and satisfying resolution. The outcome is a sequence of exactly twelve text-free, film-noir-style images in a 16:9 format that can be used by creators as a consistent visual planning tool. compatibility: Requires betterprompt >= 0.1.3 metadata: openclaw: homepage: https://github.com/BetterPromptme/skills emoji: 🧩 requires: anyBins: - betterprompt - bp os: - linux - darwin install: - id: node kind: node package: betterprompt bins: [betterprompt, bp] label: Install BetterPrompt CLI (node)

What it does

This prompt instructs an AI to produce a visually cohesive, 12-frame cinematic neo-noir storyboard featuring a detective duo investigating a missing treasure in a smoky, high-contrast urban setting. It specifies consistent character faces, outfits, and atmosphere across all frames, with each image representing a distinct story beat that escalates tension through emotional highs and lows before landing on a twist and satisfying resolution. The outcome is a sequence of exactly twelve text-free, film-noir-style images in a 16:9 format that can be used by creators as a consistent visual planning tool.

For more installation instructions go to https://raw.githubusercontent.com/BetterPromptme/skills/refs/heads/main/betterprompt/SKILL.md to check out this skill.

Inputs

textInputs

Pass each text input using --input <key>=<value> flags.

Variable key	Required?	Description	Defaults
seed	Optional	A randomization number to ensure reproducible results (if the AI engine supports it). Using the same seed usually recreates the same composition.	12345
story_theme	Optional	The central plot theme or narrative arc that drives the storyboard.	missing treasure
aspect_ratio	Optional	The frame ratio of your storyboard images.	16:9
lighting_style	Optional	The overall lighting mood that defines the atmosphere.	high-contrast, smoky atmosphere
character_roles	Optional	The archetype or role of the characters in the story. Helps the model keep their narrative function consistent.	detective, partner,...
location_setting	Optional	The main environment where the story takes place. Sets the visual backdrop.	urban noir city

imageInputs

This prompt requires exactly 2 images. You must pass exactly 2 image flags (no more, no fewer), in the order matching the descriptions below.

Index	Required	Description	Allowed CLI flags
1	Yes	A clear reference photo of your main character (front-facing if possible)	--image-input-url <url> or --image-input-path <path>
2	Yes	A clear reference photo of the supporting character (partner, rival, or secondary lead)	--image-input-url <url> or --image-input-path <path>

Models and options

This skill's modality is: image.

To discover which model values you can use (and which options keys/values are valid for each model), run:

betterprompt resources --models-only --json

Then filter the returned JSON array to entries where modality is "image".

How to run

Step 1: Collect inputs

First, run betterprompt resources --models-only --json and filter to modality: "image" to discover valid models and available options:

betterprompt resources --models-only --json

Use only the models and option values that appear in the filtered results.

Then collect all inputs from the human:

• Optional text inputs (use defaults if not provided by the human):
  • seed (default: 12345)
  • story_theme (default: missing treasure)
  • aspect_ratio (default: 16:9)
  • lighting_style (default: high-contrast, smoky atmosphere)
  • character_roles (default: detective, partner,...)
  • location_setting (default: urban noir city)
• Required images:
  • Exactly 2 images: image 1 (A clear reference photo of your main character (front-facing if possible)) and image 2 (A clear reference photo of the supporting character (partner, rival, or secondary lead)). Images must be provided in this order.
• Optional: model and options.
  • Present the human with the default model gemini-2.5-flash-image-preview and its available options. Look up gemini-2.5-flash-image-preview in the betterprompt resources output (filtered to modality "image") and show its availableOptions as: key: val1, val2 (default), val3 | key2: .... Mark a value (default) if it matches these defaults: {}.
  • If the human does not specify, defaults are used: model gemini-2.5-flash-image-preview, options {}. Other models from the resources call are also available.

If the required images are missing, ask the human for what's missing. Do not assume or fabricate values. Tell the human: "Please provide images in this order: image 1 (A clear reference photo of your main character (front-facing if possible)) and image 2 (A clear reference photo of the supporting character (partner, rival, or secondary lead))".

Step 2: Run via BetterPrompt CLI

Use the frontmatter's name as the positional argument (for this skill, use movie-storyboard).

Command form:

betterprompt generate movie-storyboard \
  [--input <key>=<value>] \
  [--image-input-url <url>] \
  [--image-input-path <path>] \
  [--model <model>] \
  [--options <options JSON>] \
  [--json]

Notes:

• Pass each text input as a separate --input <key>=<value> flag.
• Pass each image using --image-input-url or --image-input-path, in the order matching the imageInputs descriptions (image 1 first, then image 2, etc.).
• If the human does not mention a model, omit --model and BetterPrompt will use the default model: gemini-2.5-flash-image-preview.
• If the human does not mention options, omit --options and BetterPrompt will use the default options: {}.
• If the run times out, the response will include a runId you can use to fetch the result later.

Example (using defaults shown above):

betterprompt generate movie-storyboard \
  --input seed=12345 \
  --input 'story_theme=missing treasure' \
  --input aspect_ratio=16:9 \
  --input 'lighting_style=high-contrast, smoky atmosphere' \
  --input 'character_roles=detective, partner,...' \
  --input 'location_setting=urban noir city' \
  --image-input-url https://example.com/image1.png \
  --image-input-path /path/to/image2.png \
  --model gemini-2.5-flash-image-preview \
  --options '{}'