cinematic-storyboard-sheet
Generate professional Hollywood-caliber vertical storyboard sheet images from cinematic storyboard text, shot lists, scripts, or character reference images. Use when Codex must call image_gen to creat
SKILL.mdcinematic-storyboard-sheet/SKILL.md
GitHubCinematic Storyboard Sheet
Overview
Create a polished vertical storyboard sheet image as a continuous top-to-bottom cinematic timeline. This skill is image-only: when it is invoked, call image_gen with the completed prompt and do not return a text prompt, plan, explanation, markdown sheet, or any non-image artifact.
Prioritize production-design clarity: widescreen frame thumbnails, precise shot metadata, bordered text blocks, restrained black-and-grey styling, and no calendar dates anywhere in the rendered sheet.
Output Contract
- Always use the
image_gentool to generate the final storyboard sheet image. - Do not use file generation, SVG/HTML composition, plain text, or prompt-only output as the final result.
- Do not ask clarifying questions before generation; make reasonable cinematic assumptions from the provided storyboard text and character references.
- If the user provides incomplete storyboard text, generate a professional storyboard sheet image with inferred shot details or clearly designed placeholder shot rows.
- If
image_genis not available in the current environment, do not substitute another output format.
Workflow
- Parse the user's storyboard text into frames, preserving shot order.
- Extract or infer for each frame: timestamp/timecode, shot number, shot title, action, camera/lens/movement, lighting/color, and dialogue if present.
- Use referenced character images as identity and costume references when available; preserve distinguishing features consistently across frames.
- Compose one complete
image_genprompt that includes the full layout specification and all parsed frame content. - Run the quality gate below against the prompt before generation.
- Call
image_genimmediately with that prompt as the final action.
Layout Specification
- Format: one continuous vertical sheet, read top to bottom as a timeline.
- Background: pure black only.
- Typography: light grey text, clean production-board hierarchy, high legibility, no decorative clutter.
- Frame area: left column contains cinematic frames in a strict 3:2 aspect ratio.
- Text area: right column aligns side-by-side with its corresponding frame.
- Frame metadata: each frame must clearly show
Timestamp,Shot Number, andShot Title. - Timestamp meaning: use only story timecode or relative shot timing supplied by the user. Do not render calendar dates, years, month names, day names, or production-date stamps.
- Required text blocks: include bordered sections labeled exactly
Action,Camera / Lens / Movement, andLighting / Color. - Dialogue rule: if spoken lines exist, add a separate bordered
Dialoguesection immediately next to theActionsection. If no spoken lines exist, omitDialogueentirely. - Borders: use thin light-grey borders around every required text block and optional dialogue block.
- Continuity: align each text cluster to the vertical center/top rhythm of its corresponding frame; avoid orphaned labels, floating text, or mismatched frame descriptions.
Prompt Pattern
Use and adapt this prompt inside the image_gen call. Do not display this prompt to the user as the final answer.
Create a professional, Hollywood-caliber vertical storyboard sheet as a continuous top-to-bottom timeline.
Visual system:
Pure black background. Light grey typography and thin light grey borders. Premium cinematic production-board design, precise spacing, readable hierarchy, no decorative noise. Absolutely no calendar dates, years, month names, day names, watermarks, or production-date stamps anywhere on the sheet.
Layout:
Each row contains a 3:2 cinematic frame on the left and its matching text panel on the right. Keep every frame and text panel aligned side-by-side. The sheet reads as one continuous vertical timeline from top to bottom.
Per frame:
Clearly display Timestamp, Shot Number, and Shot Title. Timestamp means story timecode or relative shot timing only, never a calendar date.
Beside each cinematic frame, create bordered text blocks labeled exactly:
Action
Camera / Lens / Movement
Lighting / Color
If the frame includes spoken lines, create a separate bordered Dialogue section immediately next to the Action section. If the frame has no spoken lines, omit Dialogue completely.
Use the supplied storyboard text as the source of truth:
[PASTE STORYBOARD TEXT]
Use the referenced character images only as visual identity, wardrobe, and continuity references:
[DESCRIBE OR ATTACH CHARACTER REFERENCES]
Final output requirement:
Generate the storyboard sheet as a single finished image. Do not include extra explanatory text outside the image.
Quality Gate
Verify before calling image_gen:
- No calendar dates, years, month names, day names, or production-date stamps appear on the sheet.
- Every frame has
Timestamp,Shot Number, andShot Title. - Every frame has bordered blocks labeled exactly
Action,Camera / Lens / Movement, andLighting / Color. Dialogueappears only when spoken lines exist and is positioned immediately next toAction.- Left-side frames are consistently 3:2, cinematic, and visually tied to the corresponding right-side text.
- The final sheet uses black background, light grey typography, and light grey block borders.