vvv

2 files shipped with this skill. Inline text is the catalog copy. The upstream link is the source repository.

• skills/vvv/SKILL.md7.9 KBupstream ↗

  ---
  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.
  
  ### Template
  
  `--kit KIT` is optional: the helpers use `$VVV_KIT`, then the `kits/remotion` beside this skill (a clone or the Claude Code plugin).
  
  1. `python3 scripts/vvv.py templates` lists each template with its description, formats and photo needs. Choose by purpose, then format (16:9 for a screen, 9:16 for a phone); ask if you don't know where it will play.
  2. `python3 scripts/vvv.py describe --template ID [--format F]` prints one compact JSON: slots with hints, copy fields, props, music, which couple fields the template **shows** and where, and for templates with a page timeline the **seconds per page** at the default track. Tell the user up front what will not appear (an English name, the date) and whether pages will feel rushed.
  3. Photos: local files or folders, or a 百度网盘 share link ([cloud storage](references/cloud-storage.md)). `init --photos ...` copies them downscaled to 2560 px (`--faces` adds face boxes when OpenCV is installed). `init --example` builds a demo from the template's own inputs. `--style NAME` applies a saved studio look.
  4. Look at every photo and write `creative/photo-tags.json` (mood, subject, date, and `set` for the outfit); `arrange` places them so each page keeps one outfit and paired pages change outfit. Show the user `creative/arc-sheet.jpg`. Replace every line of demo copy and confirm names and dates.
  5. Music: `music add --project P --file SONG` for the user's file, or the [music reference](references/music-and-sound.md) for a song they name. Then `music fit --project P` chooses where the song starts and the pace so the chorus opens the climax page; tell the user the length and the seconds per page, and `--apply` once agreed.
  6. `doctor --project P` (applies `npm ci`, `npm run music`), `validate`, then sample the hardest range at `--scale 0.5`, `check` it and look at it. Fix the worst peaks `check` lists. Render the full film, `check` again, deliver. Offer `style save` when more films in this style will follow.
  
  When the kit's template changes after a project was made, `update --project P` reports what would change; `--apply` takes the kit's version of files the project has not edited and lists edited ones as conflicts.
  
  Helper errors are one JSON object, `{"status": "failed", "code", "message", "next"}`; follow `next`.
  
  ### Recreation
  
  Get the reference (`scripts/vvv_video.py fetch` for share links), measure its rhythm, then **write the page inventory before any code**: every page's beats, photo boxes, how each element enters, how the page leaves, text and decoration. [scripts/vvv_ref.py](scripts/vvv_ref.py) makes the evidence: `sheet` (0.5 s overview, 0.1 s around every transition), `layout` (boxes of settled frames), `compare` (reference and rebuild side by side). Rebuild from the inventory: generate the visual elements (lettering, ornaments, line art, textures, frames) through an image route with reference crops as style references, and keep code for layout, motion and editable text. Compare frame by frame. Never ship the reference itself. Details: [recreation](references/recreation.md).
  
  ### Brainstorm
  
  Pin down who watches, where, how long and the one takeaway. Offer three treatments that differ in structure, each with a beat sheet; recommend one and sample its hardest scene first.
  
  ## Check, look, deliver
  
  ```text
  python3 scripts/vvv.py check --project PROJECT            # latest sample or render
  python3 scripts/vvv.py check --video FILE --beats MAP     # any file, such as a reference
  ```
  
  Fix failures first; `BEAT_SYNC` lists the worst peaks with their signed offsets, and [craft](references/craft.md#land-the-change-on-the-beat) says how far to move each kind of move. Passing is the floor, not approval. Then look, read and listen, following [Review and handoff](references/review-handoff.md), which also covers delivery (including uploading to 百度网盘 when asked). When the film goes to someone else, offer `pack --project` so their agent can continue it.
  
  ## Ground rules
  
  - Facts about real people come from the user. Generated pictures of them stay identifiable as generated; never invent events to fill a gap.
  - Use only music, clips and voices the user may use. Mixkit tracks are fetched by `npm run music` and never redistributed. A song fetched with musicdl is for that user's own film only and never enters a template or package.
  - Never install musicdl or OpenCV, and never read or print tokens (TikHub, 百度网盘): `next` asks the user.
  - Use image or video generation only through a route that is available and authorized in this session. A failed route never authorizes a paid fallb

• README.mdupstream ↗

  Contents are not inlined in the catalog. Open the upstream file.

Plain-text copy, no login: /skill-bundles/actionow-ai-vvv-skills-vvv.md