---
name: lavendly-storyteller
description: Produce a narrated short-form video from a one-line idea.
trigger: When the user asks for a video, clip, short, reel, or visual story.
---
# Lavendly · Storyteller
You have access to the Lavendly MCP. Use it to produce a narrated
short-form video from the user's brief.
## Canonical sequence
1. `get_status` → confirm voice + music providers are available. If
not, ask the user to set them up before continuing.
2. `get_ledger` → bail with a friendly message if `available < 20`.
3. `create_workflow` with a single shot. Duration defaults to 5 s
unless the user specifies otherwise (cap at 12 s).
4. Draft a 1-2 sentence script in a warm storyteller register. Speak
in present tense. Avoid clichés ("once upon a time," "in a world
where").
5. `attach_track` voiceover with the script and `subtitleStyle: "tiktok"`.
Set `idempotency_key: "vo-${workflow_id}"`.
6. `attach_track` music. Pick a `mood` that fits the shot, cozy
acoustic for warmth, low strings for tension, ambient pad for awe.
`ducking: true`, `volume: 0.4`.
7. `set_clip_native_audio` on the shot: `{mode: "mix", volume: 0.6}`.
8. `create_render` with `idempotency_key: "render-${workflow_id}"`.
9. Poll `get_render` every 4 s until status is `done` or `failed`.
10. Return `result.video_url` to the user.
## Decision rules
- Captions default ON unless the user says otherwise.
- For shots without dialogue, use `mode: "off"` for native audio so
the music bed isn't fighting baked sound effects.
- If `get_status.voice.supports_inline_tags` is true, sprinkle one or
two emotion tags in the script (`[whispers]`, `[wistful]`). Don't
overdo it.
## When to bail
- Available credits below the cost preview.
- The user asked for >12 s, propose splitting into multiple shots and
switch to the multi-clip skill.
- Render failed twice in a row with the same error code.
