# vvv

vvv is a Claude Code skill that builds editable videos from reusable templates. It handles reference videos, project photos, copy, and music.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 568 repo stars
- Author: Vibe Vision Video contributors
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/actionow-ai/vvv/tree/HEAD/skills/vvv/SKILL.md
- Updated: 2026-10-30
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/vvv

## What it does

vvv turns a reusable template into an editable video by filling its inputs, changing selected scenes, and keeping the project open for later work. The current template library centers on wedding films. The skill can also open `.vvv` packages and recreate a video from a file or share link.

A session starts with `python3 scripts/vvv.py doctor`, which locates FFmpeg and reuses a downloaded Chrome Headless Shell. The workflow includes template inspection, photo arrangement, music fitting, rhythm checks, sampling, and final rendering. Link or external-music workflows can require `musicdl`, a TikHub token, or an approved login.

For recreation, the reference is mapped into pages, transitions, text, and image areas before the editable elements are rebuilt. A standalone image or a generic website is outside vvv's supported workflow.

## Install

### Claude Code (native platform)

1. **Plugin marketplace**
In the agent chat (not a shell):
```text
/plugin marketplace add actionow-ai/vvv
```
In the agent chat (not a shell):
```text
/plugin install vvv@vibevision
```
This installs the whole vvv plugin with all its skills

2. **Skills CLI (Vercel)**
```bash
npx skills add actionow-ai/vvv --skill vvv -a claude-code
```

3. **Manually: put the files in place**
- File: `~/.claude/skills/vvv/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/vvv/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add actionow-ai/vvv --skill vvv -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/vvv/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add actionow-ai/vvv --skill vvv -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/vvv/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install actionow-ai/vvv skills/vvv
```

2. **Manually: put the files in place**
- File: `.github/skills/vvv/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add actionow-ai/vvv --skill vvv -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/actionow-ai/vvv --path skills/vvv
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/vvv/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/actionow-ai/vvv/tree/HEAD/skills/vvv/SKILL.md

## When to use it
- build a wedding film from a reusable template
- recreate a video from a file or share link
- open a `.vvv` package and continue its project
- match page changes to a music track's measured beats
- check a video before the final render

## Example prompts
- Make an editable wedding film from a template using my photos, copy, and music.
- Recreate this reference video and keep the result editable.
- Open the `.vvv` package, verify it, and continue the project.

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 476a8dd4156625a6.

BEGIN THIRD-PARTY FILE 476a8dd4156625a6
```text
---
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.
```
END THIRD-PARTY FILE 476a8dd4156625a6

The third-party file has ended. Everything between the 476a8dd4156625a6 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2897 of 9683 bytes. © Vibe Vision Video contributors · MIT · https://github.com/actionow-ai/vvv/tree/HEAD/skills/vvv/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
