shellbot-creative

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

Authentication and provider checks

Support any of these providers:

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)

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.

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"
}'

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"}}'

curl -s -X POST "https://queue.fal.run/fal-ai/flux-2" \
  -H "Authorization: Key $FAL_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt":"Cyberpunk storefront, rainy night","image_size":"landscape_16_9"}'

$0 = edit

Perform image editing/upscaling/background work before animation.

See references/workflow-recipes.md for edit chains.

$0 = video

Generate motion scenes from prompts or keyframes.

Always save scene outputs in a structured project folder:

mkdir -p ./creative-output/{assets,scenes,audio,final,manifests}

$0 = voice

Generate narration.

Use concise script-first narration lines generated from storyboard scenes.

$0 = music

Generate background music and keep loudness headroom for voiceover.

$0 = remotion

Assemble final video with composited assets, generated clips, captions, and audio mix.

npx create-video@latest creative-video
cd creative-video

Generate a Remotion manifest from the storyboard:

python3 ../scripts/remotion_manifest_from_storyboard.py \
  --storyboard ../storyboard.json \
  --fps 30 \
  --voiceover-url "https://example.com/voice.mp3" \
  --music-url "https://example.com/music.mp3" \
  --out ./src/creative-manifest.json

Then implement composition using assets/remotion/ProductMarketingTemplate.tsx as a baseline.

$0 = pipeline

Run end-to-end sequence:

1. plan from brief 2. asset generation per scene 3. edit and upscale selected assets 4. video generation for hero scenes 5. voice + music 6. remotion assembly + render

If the user asks for a product marketing or explainer video, this is the default command path.

$0 = status

Check async task status for Freepik/fal requests and report:

$0 = sample

Load ready-to-run workflows from references/samples.md.

Quality bar for "outstanding" creative output

Always enforce:

Production workflow policy

Local resources included in this skill

References