$npx -y skills add MagicCube/agentara --skill video-storyboardGenerate storyboard image boards and matching video-generation prompt scripts for specific scenes in a short video plan. Use this skill whenever the user asks to create a storyboard, storyboard image, video prompt script, scene prompt, image-to-video prompt, shot board, or per-sc
| 1 | # Video Storyboard |
| 2 | |
| 3 | Use this skill to create a production-ready storyboard package for a specific scene: |
| 4 | |
| 5 | 1. A storyboard image saved to `storyboard/scene-XX.png`. |
| 6 | 2. A video-generation prompt script saved to `storyboard/scene-XX.md`. |
| 7 | |
| 8 | Write the skill instructions in English, but create the user-facing `.md` script in the user's preferred local language unless they explicitly request another language. |
| 9 | |
| 10 | ## When to Use |
| 11 | |
| 12 | Use this skill when the user asks for any of the following: |
| 13 | |
| 14 | - Generate a storyboard for a scene. |
| 15 | - Turn a scene from a video plan into storyboard frames. |
| 16 | - Create prompts for generating video from storyboard panels. |
| 17 | - Save a storyboard image and prompt script for `scene-01`, `scene-02`, etc. |
| 18 | - Build a grid storyboard with per-panel timing labels. |
| 19 | |
| 20 | If the user only asks for a storyboard image, still consider whether a matching `.md` prompt script is expected from the workflow. If unclear, ask one concise question or proceed with both files when the user has previously used this workflow. |
| 21 | |
| 22 | ## Inputs to Extract |
| 23 | |
| 24 | Before generating, identify: |
| 25 | |
| 26 | - Scene number. |
| 27 | - Scene duration. |
| 28 | - Scene source: existing plan, prior conversation, user prompt, uploaded image, or file. |
| 29 | - Aspect ratio of the final video, usually `16:9` unless specified. |
| 30 | - Characters and identity constraints. |
| 31 | - Available character design assets: `.png` character sheets, `.md` character specs, turnarounds, casting references, or prior approved character images. |
| 32 | - Wardrobe, props, brand/product details, and location. |
| 33 | - Visual style and references. |
| 34 | - Required output language for the `.md` prompt script. |
| 35 | |
| 36 | If the scene number is missing, ask for it. If duration is missing, infer it from the referenced plan; otherwise ask or choose a practical default only if the user wants you to proceed. |
| 37 | |
| 38 | ## Output Paths |
| 39 | |
| 40 | Always use a two-digit scene number: |
| 41 | |
| 42 | - Scene 1 -> `storyboard/scene-01.png` and `storyboard/scene-01.md` |
| 43 | - Scene 2 -> `storyboard/scene-02.png` and `storyboard/scene-02.md` |
| 44 | - Scene 12 -> `storyboard/scene-12.png` and `storyboard/scene-12.md` |
| 45 | |
| 46 | Create `storyboard/` if it does not exist. |
| 47 | |
| 48 | Do not overwrite existing storyboard files unless the user asked for regeneration or replacement. If a target file exists, either ask before replacing or write a clear revision path such as `scene-01-v2.png` if the user requested alternatives. |
| 49 | |
| 50 | ## Grid Rules |
| 51 | |
| 52 | Choose grid size from the scene duration: |
| 53 | |
| 54 | | Scene Duration | Grid | Panel Count | |
| 55 | | ---: | --- | ---: | |
| 56 | | `<= 9s` | `3 rows x 3 columns` | 9 panels | |
| 57 | | `> 9s` and `<= 12s` | `4 rows x 3 columns` | 12 panels | |
| 58 | | `> 12s` | `4 rows x 4 columns` | 16 panels | |
| 59 | |
| 60 | Each panel must be `16:9`. |
| 61 | |
| 62 | There must be no gaps between panels. Use thin black panel borders only if needed for readability, but do not insert gutters or spacing. |
| 63 | |
| 64 | If the duration does not divide evenly, allocate practical panel durations. Prefer simple labels such as `0.5s`, `1s`, `1.5s`, `2s`, or exact ranges when helpful. Empty final panels are allowed for very short scenes, but only when filling every panel would over-fragment the action. Empty panels should be plain black. |
| 65 | |
| 66 | ## Storyboard Image Requirements |
| 67 | |
| 68 | Generate one single storyboard sheet, not separate images. |
| 69 | |
| 70 | If the current context includes a character design image, approved character sheet, turnaround sheet, or character reference `.png`, use it as an image reference for the storyboard image generation. Do not rely on text description alone when a character design image is available. This is required to preserve identity, face, hairstyle, body proportions, wardrobe, and material details across scenes. |
| 71 | |
| 72 | If both a character `.md` spec and `.png` sheet exist, read the `.md` for written constraints and feed the `.png` to the image-generation model as the visual reference. |
| 73 | |
| 74 | Every visible panel must include: |
| 75 | |
| 76 | - A black rectangle in the top-left corner with the panel number in white text, starting from `1`. |
| 77 | - A black rectangle in the top-right corner with the panel duration in white text, such as `0.5s`, `1s`, or `1.5s`. |
| 78 | - A clear shot composition that corresponds to the panel's beat. |
| 79 | |
| 80 | Critical continuity requirements: |
| 81 | |
| 82 | - Keep the same character identity across all panels. |
| 83 | - Keep face, age, hairstyle, body type, and skin tone consistent. |
| 84 | - Keep wardrobe consistent unless the scene explicitly includes a costume change. |
| 85 | - Keep key props consistent, including product shape, color, bottle |