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

- **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:

```bash
[ -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.

```bash
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:

```bash
python3 scripts/creative_prov...