Vibe Vision Video skill

---
name: vvv
description: Use when making, recreating or continuing an editable video from reusable templates (the current library covers wedding films), including recreating a reference video (a file or a 抖音/小红书/快手/TikTok share link) with the user's photos (local or 百度网盘), copy and music, or opening a .vvv package. Not for a standalone image or a generic website.
---

# vvv

Vibe Vision Video (VVV) builds a video template once and reuses it: for each new film, fill the template's inputs, change only the scenes the brief needs, and keep the editable project. The current template library focuses on wedding films. Every route ends the same way: render, measure with `vvv check`, look at it yourself, fix, deliver.

## The bar

A VVV film is worth watching when:

- **The first three seconds give a reason to stay:** faces, a shared memory, a question.
- **Something is always changing.** Nothing stands still longer than the template allows (usually 3 s); even a reading hold breathes.
- **Changes land on measured beats** of the actual track.
- **One thing to read at a time,** held long enough (about 5 s a page or more), broken where the author chose.
- **Each format is laid out for itself;** 9:16 is not a crop of 16:9.
- **The content is real and right:** the user's photos, correct names, confirmed dates and events.
- **The sound is intended:** music the user may use, at a sensible level, faded at the ends.

[Craft](references/craft.md) explains how to get there, including where each kind of move peaks against the beat.

## Pick the route

| The user has | Route | Start with |
|---|---|---|
| A purpose a template covers | **Template** | [Templates and projects](references/projects.md) |
| A reference video to match ("make it like this one"), as a file or a share link | **Recreation (复刻)** | [Recreation](references/recreation.md) |
| An idea, or no treatment yet | **Brainstorm** | [Brainstorm](references/brainstorm.md) |
| An existing VVV project or render | **Continue** | [Production and continuation](references/production.md) |
| A `.vvv` file (template, project or effect) | **Open the package** | [.vvv packages](references/vvv-format.md): `verify` first, then `init`, `unpack` or `add` |

## Set up without the user

The user only briefs, watches samples and gives feedback; environment and commands are your job. Before the first project command of a session, run `python3 scripts/vvv.py doctor` (add `--project DIR` once a project exists). It finds FFmpeg (Remotion's own when none is installed) and reuses a Chrome Headless Shell this computer already downloaded. Every failed check, and every failed helper command, carries `next`:

- `run`: run `command` yourself (in `cwd` when given), then retry what failed.
- `ask_user`: the fix needs the user's permission, account or material; ask `say` in one sentence, in the user's language.
- `fix`: work it out from the message and `hint`.

Never hand the user a command to type, a stack trace or an error code; the exception is a step only they can take on their own account (installing musicdl, saving a TikHub token, approving a login), which `next` words for you.

Routes combine: a brainstorm often lands on a template, and a recreation can become one. Ask the user only when the answer changes the film (audience, a missing fact, the format, the treatment); make routine choices yourself and say what you chose.