Skip to content
OpenAgentSkill
Browsing is open · Catalog captured 2026-11-21 · Automatic updates and account services are paused.
Design & UI

storyboard-final-frame-optional

Optional branch for generating final styled storyboard frames from approved line art. Use only when the user explicitly asks for finished frames; accept either a user-provided style image or a text style lock.

kevinchin12 · Static checks on file

Installation

Read the source and dependencies before running a command. Copying does not install or execute anything.

npx skills add kevinchin12/storyboard-director --skill storyboard-final-frame-optional

About this skill


name: storyboard-final-frame-optional description: "Optional branch for generating final styled storyboard frames from approved line art. Use only when the user explicitly asks for finished frames; accept either a user-provided style image or a text style lock."

Storyboard Final Frame Optional

Use this sub-skill only when the user explicitly asks to generate finished frames. Accept either a style-reference image or a text style lock.

This branch is not part of the default storyboard flow.

Runtime Root

Resolve STORYBOARD_DIRECTOR_ROOT before running commands:

  • installed bundle: ${CODEX_HOME:-$HOME/.codex}/skills/storyboard-director
  • source checkout: the nearest ancestor containing both the main SKILL.md and scripts/

Use absolute script paths. Do not assume the current workspace contains the skill source folder.

Session Resolution

Use the explicit session path when provided. Without one, inspect configured sessions/ and examples/ and proceed only when exactly one session matches the request. If several sessions could match, ask for the exact path; never choose the newest session by guesswork.

Scope

Do:

  • read an existing approved session.json
  • ingest style reference images or text style locks
  • set display_options.show_final_frames to true
  • generate final frames from approved line art plus style rules
  • save/register final frames under assets/
  • optionally generate the final-frame storyboard sheet when requested
  • render HTML with final-frame sections visible

Do not:

  • run by default
  • generate final frames before script and line art are approved
  • change shot order, character identity, composition, or line-art structure
  • treat a style reference as permission to copy unrelated subjects or scenery
  • upload generated final frames for AI review unless the user names a problem shot
  • ask for API keys or switch to CLI/API image fallback

Style Translation

Style references may control:

  • color logic
  • texture
  • line quality
  • rendering finish
  • atmosphere
  • lighting mood

They must not override:

  • character identity
  • scene anchors
  • composition
  • camera angle
  • action freeze
  • approved line-art structure

Multi-Agent Rule

For two or more independent frames, build the full queue first and use up to three workers. Reduce concurrency to one or two for exact people, products, landmarks, readable text, or tightly continuous spaces, and record the reason.

Workers generate images and return explicit local source paths only. The orchestrator alone registers assets, edits session state, and renders HTML. Never share one capture marker across concurrent workers.

Prompt Shape

Use this structure:

Use case: sketch-to-render / illustration-story
Asset type: final static storyboard frame for <Shot ID>.
Input references: <style image role>; <line-art image role>.

Primary request:
Generate a final colored static frame in the locked project aspect ratio <aspect_ratio> by combining the saved line-art composition with the style reference. Real image-model raster output only.

LOCKED STRUCTURE FROM LINE ART:
<composition, camera, subject placement, action, key objects, depth relationships>

STYLE TRANSLATION FROM REFERENCE IMAGE:
<medium, texture, paper, line quality, palette mapping, finish level>

IMPORTANT AVOID:
Do not copy unrelated subjects or scenery from the style reference. Do not add text, readable labels, logos, captions, panel borders, UI, watermarks, extra characters, or composition changes. Preserve the line-art structure.

Registration

Register each final frame:

python3 "$STORYBOARD_DIRECTOR_ROOT/scripts/register_story_asset.py" SESSION.json --asset-type final-frame --shot-id "Shot 01" --source SOURCE_IMAGE --output-name shot01-final.jpg --validate-profile smoke --workspace-root /path/to/workspace

For a storyboard sheet:

python3 "$STORYBOARD_DIRECTOR_ROOT/scripts/generate_storyboard_sheet.py" SESSION.json --asset-type final-frame --validate-profile workflow --workspace-root /path/to/workspace

Preferred built-in image_gen capture is the same as line art:

python3 "$STORYBOARD_DIRECTOR_ROOT/scripts/capture_generated_asset.py" SESSION.json --mark --workspace-root /path/to/workspace

Then call image_gen, and register:

python3 "$STORYBOARD_DIRECTOR_ROOT/scripts/capture_generated_asset.py" SESSION.json --asset-type final-frame --shot-id "Shot 01" --output-name shot01-final.jpg --workspace-root /path/to/workspace