shellbot-creative

Create high-end creative outputs by chaining providers intentionally:

1. Generate reusable assets (Nano Banana 2 / Freepik / fal)
2. Generate scene motion (Freepik Kling / fal video models)
3. Add voice and music (Freepik ElevenLabs voiceover + music or fal equivalents)
4. Assemble and polish in Remotion

Use this skill as a production orchestrator, not as isolated single calls.

Arguments

• Command: $0 (plan | asset | edit | video | voice | music | remotion | pipeline | status | sample)
• Arg 1: $1 (provider, model, or workflow type)
• Arg 2+: $2, $3, etc.
• All args: $ARGUMENTS

Authentication and provider checks

Support any of these providers:

• FREEPIK_API_KEY for Freepik API
• FAL_KEY for fal.ai API
• INFERENCE_API_KEY (or infsh login) for Nano Banana 2 via inference.sh

Before any generation call:

[ -n "$FREEPIK_API_KEY" ] && echo "Freepik ready"
[ -n "$FAL_KEY" ] && echo "fal ready"
command -v infsh >/dev/null && echo "infsh available"

If a requested provider is not authenticated, route to another available provider and clearly explain the fallback.

Provider routing (opinionated defaults)

• Asset ideation / strong multi-image consistency: Nano Banana 2
• Photoreal product hero, posters, typography, upscale/edit suite: Freepik
• Fast model exploration or niche fal endpoint needs: fal.ai
• Final timeline composition, transitions, captions, audio mix: Remotion

Read references/provider-matrix.md for exact model choices.

Command behavior

$0 = plan

Turn a user brief into a production storyboard and shot list.

python3 scripts/creative_brief_to_storyboard.py \
  --brief "Launch video for a new fitness app aimed at busy professionals" \
  --format product-marketing \
  --duration 45 \
  --aspect-ratio 16:9 \
  --out storyboard.json

Then create a provider/model routing recommendation:

python3 scripts/creative_provider_router.py \
  --goal full-video \
  --priority quality \
  --needs-consistency true \
  --needs-typography true

$0 = asset

Generate still assets for scenes.

• Nano Banana 2 default (consistency + editing):

infsh app run google/gemini-3-1-flash-image-preview --input '{
  "prompt": "Premium SaaS dashboard on a laptop, soft studio light",
  "aspect_ratio": "16:9",
  "num_images": 4,
  "resolution": "2K"
}'

• Freepik high-fidelity product image (Mystic):

curl -s -X POST "https://api.freepik.com/v1/ai/mystic" \
  -H "x-freepik-api-key: $FREEPIK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt":"Studio product shot of matte black earbuds on reflective surface","resolution":"2k","styling":{"style":"photo"}}'