# Storyboard Av Mix

> >-

- **Type:** Skill
- **Install:** `agentstack add skill-godot-fun-godot-framework-storyboard-av-mix`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [godot-fun](https://agentstack.voostack.com/s/godot-fun)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [godot-fun](https://github.com/godot-fun)
- **Source:** https://github.com/godot-fun/godot-framework/tree/main/.cursor/skills/storyboard-av-mix

## Install

```sh
agentstack add skill-godot-fun-godot-framework-storyboard-av-mix
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Storyboard AV Mix

Take a work directory with **per-shot** video and bilingual VO. For each shot, **retime the video to the full VO duration** (audio master), drop original video audio, mux, and write language-specific folders.

| Input | Path |
|-------|------|
| Shot video | `/Video/.*` |
| Chinese VO | `/Chinese/.*` |
| English VO | `/English/.*` |

| Output | Path |
|--------|------|
| Chinese mux | `/Video-Chinese/.` |
| English mux | `/Video-English/.` |

## Rules

1. Follow [skill-dependency-manager](../../rules/skill-dependency-manager.md).
2. **VO timing is immutable.** Never stretch, shrink, pad, trim, or `atempo` the voice-over. Duration of the VO file is the master clock.
3. **Video serves audio.** Only change video duration (FFmpeg `setpts`) so it equals that shot’s VO length, then mux.
4. Drop all audio from the source video; replace with the VO track. Prefer `-c:a copy`; if the container cannot hold the VO codec (e.g. WAV→MP4), encode AAC **without** changing length.
5. **Do not downgrade video.** `setpts` requires a re-encode, but match the source: codec family (H.265 Main10 when source is 10-bit HEVC), `pix_fmt`, bitrate, color tags, and HDR side data (mastering display / MaxCLL). Copy container + video-stream metadata from the source clip.
6. Match shots by **filename stem** (`01.mp4` ↔ `01.wav`).
7. Batch only via `scripts/mix.py` — do not hand-write FFmpeg mux/retime commands.
8. Never overwrite inputs under `Video/`, `Chinese/`, or `English/`.

## Layout

```
/
  Video/
    01.mp4
    02.mp4
  Chinese/
    01.wav
    02.wav
  English/
    01.wav
    02.wav
  Video-Chinese/     # written by this skill
    01.mp4
    02.mp4
  Video-English/
    01.mp4
    02.mp4
```

Typical `` is a storyboard-tts audio dir that also has a sibling or nested `Video/` of cut clips — confirm the folder that contains `Video/`, `Chinese/`, and `English/`.

## Workflow

```
Task Progress:
- [ ] Confirm  (has Video/, Chinese/, English/)
- [ ] Ensure .dependency python + ffmpeg populated
- [ ] Optional trial: mix.py  --limit 1
- [ ] Full batch: mix.py 
- [ ] Chat: counts written, output dirs, any skipped shots
```

### One command

From project root:

```bash
.dependency/python/python .cursor/skills/storyboard-av-mix/scripts/mix.py path/to/
```

Per shot / language:

1. Probe VO duration (source of truth) and video duration
2. `setpts=PTS*(vo_dur/video_dur)` — stretch or compress **video only** (plus short freeze-tail so video ≥ VO)
3. Mux with `-shortest` so **container duration == VO duration** (never cut VO by making video the short side)
4. Write `/Video-Chinese|/.`

### Trial / one language

```bash
.dependency/python/python .cursor/skills/storyboard-av-mix/scripts/mix.py path/to/ --limit 1
.dependency/python/python .cursor/skills/storyboard-av-mix/scripts/mix.py path/to/ --lang chinese
```

## Flags

| Flag | Notes |
|------|--------|
| `root` | Work dir with `Video/`, `Chinese/`, `English/` |
| `--lang` | `both` (default), `chinese`, `english` |
| `--limit N` | First N shot ids only (sorted) |
| `--force` | Overwrite existing outputs |
| `--dry-run` | Plan only |
| `--crf` | Optional CRF override (default: match source bitrate) |
| `--preset` | x264/x265 preset (default `medium`) |

Skip existing outputs unless `--force`. Missing VO for a language → skip that job with a warning. Missing video → skip shot.

## Agent notes

1. Audio first: if durations disagree, change **video**, never VO.
2. Prefer one `mix.py` run for the whole board.
3. Re-encode must preserve source quality tags (Main10 / HDR / bitrate) — never force 8-bit H.264.
4. Chat summary: ``, jobs done / skipped, paths to `Video-Chinese/` and `Video-English/`.
5. Upstream VO usually from [storyboard-tts](../storyboard-tts/SKILL.md); this skill does not synthesize speech.

## Related

- [storyboard-tts](../storyboard-tts/SKILL.md) — bilingual VO under `Chinese/` / `English/`
- [storyboard](../storyboard/SKILL.md) — source markdown

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [godot-fun](https://github.com/godot-fun)
- **Source:** [godot-fun/godot-framework](https://github.com/godot-fun/godot-framework)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-godot-fun-godot-framework-storyboard-av-mix
- Seller: https://agentstack.voostack.com/s/godot-fun
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.