mcpField
M
muapi-storyboard

muapi-storyboard

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

About muapi-storyboard

muapi-storyboard is an LLM-orchestrated skill for turning a one-line premise into a sequence of image keyframes. It is suited to creating visual story plans, with parallel generation and continuity across scenes.

Key features

  1. 01Premise-to-story-beat breakdown
  2. 02Parallel keyframe image generation
  3. 03Character and setting continuity
  4. 04Ordered asset IDs with captions

Use cases

  1. 01Drafting a short story as visual scenes
  2. 02Planning a sequence of reference images

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/samuraigpt/muapi-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