muapi-storyboard

# Storyboard Generator

**Generate N keyframes for a short story or scene sequence (image only, no video).**

## Inputs

| Name | Type | Required | Default | Description |
|:---|:---|:---|:---|:---|
| `premise` | text | yes | — | One-line story premise (e.g. "lonely robot finds a tiny mechanical bird friend"). |
| `scenes` | int | no | 6 | Number of keyframes to produce. |
| `style` | text | no | cinematic, photoreal, soft lighting, 16:9 | Visual style tags applied to every keyframe. |


## Steps

Use the plan to dispatch all N keyframes in a single parallel layer.

1. Decompose `premise` into `{{scenes}}` story beats with a clear arc:
   setup → inciting moment → escalation → climax → resolution.
   - Each beat gets a one-paragraph visual description.
   - Maintain character / object continuity across beats (same character
     appearance, same world).
2. For each beat, create a `muapi image generate` node (model=nano-banana-2, aspect_ratio=16:9):
   - Prompt = `"<beat description>. {{style}}"`.
   - Tier: balanced (these are reference keyframes, not finals).
   - Aspect ratio: 16:9.
3. Run the plan in parallel (no `depends_on` between keyframes).
4. Return the asset ids in beat order with a one-line caption per scene.

## Notes
- Don't animate, upscale, or add audio — this skill is keyframes only.
  If the user wants video, suggest the `music-video` skill afterward.
- For consistency, repeat character description verbatim in every prompt
  ("a small rusty humanoid robot with…") rather than relying on the model
  to remember.

## Trigger Keywords

`storyboard`, `keyframes`, `scene sequence`, `story panels`


---

## Notes for the Executing Agent

- This recipe is LLM-orchestrated: read each phase, gather any missing inputs from the user, then call `muapi` CLI commands. Use `muapi auth configure` first if `MUAPI_API_KEY` is unset.
- For model IDs without a CLI alias yet, fall back to the raw endpoint via `curl -X POST https://api.muapi.ai/api/v1/<endpoint> -H "x-api-key: $MUAPI_API_KEY" -H 'content-type: application/json' -d '{...}'` and poll with `muapi predict wait <request_id>`.
- Substitute `{{input_name}}` placeholders with the user's actual inputs before issuing each call.