mcpField
M
muapi-storyboard

muapi-storyboard

github.com/samuraigptCreative & media25686 installsUpdated 4w ago
Repository

About muapi-storyboard

muapi-storyboard is an agent-executed recipe for generating image-only keyframes from a story premise. It breaks the premise into an ordered scene arc and creates the keyframes in parallel with consistent visual descriptions.

Key features

  1. 01Turn a premise into story beats
  2. 02Set the number of keyframes and visual style
  3. 03Generate 16:9 image keyframes with muapi
  4. 04Dispatch keyframe generation in parallel
  5. 05Return asset IDs with scene captions

Use cases

  1. 01Create keyframes for a short story
  2. 02Plan a sequence of visual scenes
  3. 03Produce reference images for a storyboard

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/samuraigpt/generative-media-skills --skill muapi-storyboard

After installing, type/muapi-storyboardin Claude Code to confirm it loaded.

Details

From the project README

Storyboard Generator

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

Inputs

NameTypeRequiredDefaultDescription
premisetextyes—One-line story premise (e.g. "lonely robot finds a tiny mechanical bird friend").
scenesintno6Number of keyframes to produce.
styletextnocinematic, photoreal, soft lighting, 16:9Visual 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.

Comments

Markdown supported