Agent skill

Storyboard Av Mix

by godot-fun in godot-fun/gai

Muxes per-shot storyboard video with Chinese and English voice-over by retiming video to match VO duration (setpts), writing Video-Chinese/ and Video-English/ (matched by shot id 01, 02, …).

MITAuto-check passedMedia & Creative

Install Storyboard Av Mix

skills CLI
$ npx skills add godot-fun/gai --skill storyboard-av-mix -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install godot-fun/gai storyboard-av-mix --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/godot-fun/gai.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/storyboard-av-mix .claude/skills/storyboard-av-mix && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
storyboard-av-mix
GitHub stars
183
Token cost
~1.1k tokens
SKILL.md length
415 words
Files
1
Skills in repo
36
Repo updated
First seen
Licence
MIT

At a glance

Muxes per-shot storyboard video with Chinese and English voice-over by retiming video to match VO duration (setpts), writing Video-Chinese/ and Video-English/ (matched by shot id 01, 02, …).

  • Works in 7 steps: VO timing is immutable. Never stretch,… → Video serves audio. Only change video… → Drop all audio from the source video;… → …
  • The user wants storyboard A/V mix
  • SKILL.md covers Rules, Quick Start, Layout and Common Flags, plus 3 more sections
  • Calls python

What it does

Storyboard Av Mix is an agent skill from godot-fun/gai. Muxes per-shot storyboard video with Chinese and English voice-over by retiming video to match VO duration (setpts), writing Video-Chinese/ and Video-English/ (matched by shot id 01, 02, …). Use when the user wants storyboard A/V mix, storyboard A/V mix, VO dubbing mix, video retime to audio, Video-Chinese, Video-English, bilingual VO on cut video, or batch mux Video/ + Chinese/ + English/.

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Media & Creative, covering Comics and storyboards, Text to speech and voice and Translation. The repository describes itself as: A lightweight AI agent and skill workflow framework built with Godot. The licence is MIT.

When your agent uses it

  • The user wants storyboard A/V mix
  • Storyboard A/V mix
  • Video retime to audio
  • Bilingual VO on cut video

Example prompts

  • “Use the storyboard-av-mix skill to mux per-shot storyboard video with Chinese and English voice-over by retiming video to match VO duration…”
  • “/storyboard-av-mix”

Requirements

  • Python 3

Workflow steps

7 steps, taken from the first numbered list in SKILL.md.

  1. VO timing is immutable. Never stretch, shrink, pad, trim, or atempo the voice-over. Duration of the VO file is the master clock.
  2. Video serves audio. Only change video duration (FFmpeg setpts) so it equals that shot’s VO length, then mux.
  3. 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…
  4. Do not downgrade video. setpts requires a re-encode, but match the source: codec family (H.265 Main10 when source is 10-bit HEVC)…
  5. Match shots by filename stem (01.mp4 ↔ 01.wav).
  6. Batch only via .ai/storyboard-av-mix/mix.py — do not hand-write FFmpeg mux/retime commands.
  7. Never overwrite inputs under Video/, Chinese/, or English/.

What it can do on your machine

Read from SKILL.md and the folder at commit 6394686. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • python

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Storyboard Av Mix loads about 1.1k tokens when it runs. Until then it costs about 103 tokens; SKILL.md has 415 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~103
When it runs · the whole SKILL.md, loaded when a task matches
~1.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from godot-fun/gai at commit 6394686, republished under its MIT licence (© godot-fun). 415 words, ~1,089 tokens.

Download SKILL.mdSave it as .claude/skills/storyboard-av-mix/SKILL.md (or your agent's skills folder).
name
storyboard-av-mix
description
Muxes per-shot storyboard video with Chinese and English voice-over by retiming video to match VO duration (setpts), writing Video-Chinese/ and Video-English/ (matched by shot id 01, 02, …). Use when the user wants storyboard A/V mix, storyboard A/V mix, VO dubbing mix, video retime to audio, Video-Chinese, Video-English, bilingual VO on cut video, or batch mux Video/ + Chinese/ + English/.

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.

InputPath
Shot video<root>/Video/<shot-id>.*
Chinese VO<root>/Chinese/<shot-id>.*
English VO<root>/English/<shot-id>.*
OutputPath
Chinese mux<root>/Video-Chinese/<shot-id>.<video-ext>
English mux<root>/Video-English/<shot-id>.<video-ext>

Rules

When this skill applies, read and follow skill-dependency-manager — run scripts as documented, install missing tools into .dependency/.

  1. VO timing is immutable. Never stretch, shrink, pad, trim, or atempo the voice-over. Duration of the VO file is the master clock.
  2. Video serves audio. Only change video duration (FFmpeg setpts) so it equals that shot’s VO length, then mux.
  3. 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.
  4. 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.
  5. Match shots by filename stem (01.mp4 ↔ 01.wav).
  6. Batch only via .ai/storyboard-av-mix/mix.py — do not hand-write FFmpeg mux/retime commands.
  7. Never overwrite inputs under Video/, Chinese/, or English/.

Quick Start

From project root:

bash
.dependency/python/python .ai/storyboard-av-mix/mix.py path/to/<root>

Single language:

bash
.dependency/python/python .ai/storyboard-av-mix/mix.py path/to/<root> --lang chinese

Per shot / language the script:

  1. Probes VO duration (source of truth) and video duration
  2. Applies setpts=PTS*(vo_dur/video_dur) — stretch or compress video only (plus short freeze-tail so video ≥ VO)
  3. Muxes with -shortest so container duration == VO duration
  4. Writes <root>/Video-Chinese| or Video-English/ / <shot-id>.<same-ext>
Show full SKILL.md (150 more words)Show less

Layout

<root>/
  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 <root> 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/.

Common Flags

FlagNotes
rootWork dir with Video/, Chinese/, English/
--langboth (default), chinese, english

Existing outputs are overwritten. 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: <root>, jobs done / skipped, paths to Video-Chinese/ and Video-English/.
  5. Upstream VO usually from storyboard-tts; this skill does not synthesize speech.
  6. Missing Python/FFmpeg → populate .dependency/ per skill-dependency-manager, retry same command.

Tests

From repo root:

bash
.dependency/python/python .ai/storyboard-av-mix/test_mix.py

Manual CLI examples: cli/storyboard-av-mix.md

© godot-fun, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .agents/skills/storyboard-av-mix of godot-fun/gai.

Open the folder on GitHubat commit 6394686

Compare with similar skills

Storyboard Av Mix next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Storyboard Av Mix compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Storyboard Av Mix this skillgodot-fun/gai183—~1.1kAutomated safety check: PassMIT
Adaptationdanjdewhurst/story-skills2861 repos~3.5kAutomated safety check: NotesMIT
Hbg Life SimulationMr-funny/hbg-life-simulation141—~5.8kAutomated safety check: PassMIT
Paper Collage Explainer Generatortl2012tl/comfyUI-llama-TE2414 repos~5.2kAutomated safety check: PassNone
Carocut Media Audiobilibili/carocut130—~2.5kAutomated safety check: PassCustom licence
Vibe Scenevericontext/vibeframe175—~1.8kAutomated safety check: PassMIT

Similar skills

  • Adaptation

    danjdewhurst/story-skills

    This skill should be used when the user asks to "make an audiobook", "narration script", "narrator", "ACX", "Findaway", "pronunciation guide", "how long is the audiobook", "adapt to a screenplay"…

    286 GitHub starsUsed in 1 repo~3.5k tokens
    Media & CreativeAuto-check: notes
  • Hbg Life Simulation

    Mr-funny/hbg-life-simulation

    Create Chinese HBG “模拟人生 / 人生副本” narrative videos with a consistent comic IP, a rapid multi-life opening, continuous natural-speed narration, synchronized short captions, dense static manga…

    141 GitHub stars~5.8k tokensUpdated 2 mo ago
    Media & CreativeAuto-check passed
  • Paper Collage Explainer Generator

    tl2012tl/comfyUI-llama-TE

    For creators, educators, and social-video editors who need a tactile paper-collage language for narration, knowledge points, opinions, or abstract topics.

    241 GitHub starsUsed in 4 repos~5.2k tokens
    Media & CreativeAuto-check passed
  • Carocut Media Audio

    bilibili/carocut

    音频素材生成与获取。批量 Edge TTS 旁白生成(支持 storyboard pacing 字段驱动语速)、BGM/SFX 检索(BGM 节奏匹配 BPM 规则)、音频时长提取。包含 Edge voice 配置、速度调整规则、durations.json 格式规范(含 audiovisualrelation 说明)和关键的音频时序规则。

    130 GitHub stars~2.5k tokensUpdated 5 mo ago
    Media & CreativeAuto-check passed
  • Vibe Scene

    vericontext/vibeframe

    Author, repair, render, and inspect VibeFrame scene projects built from STORYBOARD.md and DESIGN.md.

    175 GitHub stars~1.8k tokensUpdated 6 days ago
    Media & CreativeAuto-check passed
  • Minimax H3 Text Video Prompt

    unknowlei/minimax-h3-opencode-skills

    Downstream MiniMax H3 specialist for professional text-to-video (T2VA) prompts using the official three-field format.

    122 GitHub stars~2.3k tokensUpdated 2 mo ago
    Media & CreativeAuto-check passed

More from godot-fun/gai

All 36 skills in this repo
  • AI Text To Speech

    godot-fun/gai

    Zero-shot text-to-speech with voice cloning via IndexTTS2 (index-tts).

    184 GitHub stars~2k tokensUpdated today
    Auto-check passed
  • Audio Denoise

    godot-fun/gai

    Reduces background noise in a single audio file using FFmpeg afftdn.

    184 GitHub stars~465 tokensUpdated today
    Auto-check passed
  • Audio Fade

    godot-fun/gai

    Applies fade-in and fade-out at the start and end of a single audio file using FFmpeg.

    184 GitHub stars~652 tokensUpdated today
    Auto-check passed
  • Normalizes a single audio file to consistent LUFS loudness with true-peak limiting using FFmpeg.

    184 GitHub stars~684 tokensUpdated today
    Auto-check passed
  • Standardizes a single audio file to 44100 or 48000 Hz and exports 16-bit PCM WAV using FFmpeg.

    184 GitHub stars~638 tokensUpdated today
    Auto-check passed
  • Audio Split

    godot-fun/gai

    Splits a single audio file into two segments (part 1 before the split point, part 2 after) using FFmpeg.

    184 GitHub stars~554 tokensUpdated today
    Auto-check passed

Questions about Storyboard Av Mix

What does Storyboard Av Mix do?

Muxes per-shot storyboard video with Chinese and English voice-over by retiming video to match VO duration (setpts), writing Video-Chinese/ and Video-English/ (matched by shot id 01, 02, …). Storyboard Av Mix is an agent skill from godot-fun/gai. Muxes per-shot storyboard video with Chinese and English voice-over by retiming video to match VO duration (setpts), writing Video-Chinese/ and Video-English/ (matched by shot id 01, 02, …).

When should I use Storyboard Av Mix?

Storyboard Av Mix fits situations like: the user wants storyboard A/V mix; storyboard A/V mix; video retime to audio; bilingual VO on cut video.

How do I install Storyboard Av Mix in Claude Code?

Run `npx skills add godot-fun/gai --skill storyboard-av-mix -a claude-code`. Or copy the skill folder (.agents/skills/storyboard-av-mix in godot-fun/gai) into .claude/skills/storyboard-av-mix in your project. Claude Code loads it when a task matches its description.

How do I install Storyboard Av Mix in Codex?

Run `npx skills add godot-fun/gai --skill storyboard-av-mix -a codex`. Or copy the skill folder (.agents/skills/storyboard-av-mix in godot-fun/gai) into .agents/skills/storyboard-av-mix in your project. Codex loads it when a task matches its description.

Can I use Storyboard Av Mix in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add godot-fun/gai --skill storyboard-av-mix -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/storyboard-av-mix, .gemini/skills/storyboard-av-mix, .github/skills/storyboard-av-mix and .opencode/skills/storyboard-av-mix in your project.

What does Storyboard Av Mix need to run?

Going by SKILL.md and its folder, Storyboard Av Mix needs the command-line tools its instructions call (python). Our summary lists: Python 3.

Does Storyboard Av Mix access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Storyboard Av Mix safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Storyboard Av Mix use?

Storyboard Av Mix is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Storyboard Av Mix use?

About 1.1k tokens (SKILL.md is roughly 4.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Storyboard Av Mix?

Skills that share tags, products or a category with Storyboard Av Mix: Adaptation (danjdewhurst/story-skills, 286 stars), Hbg Life Simulation (Mr-funny/hbg-life-simulation, 141 stars), Paper Collage Explainer Generator (tl2012tl/comfyUI-llama-TE, 241 stars) and Carocut Media Audio (bilibili/carocut, 130 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Storyboard Av Mix?

godot-fun (a GitHub organization) maintains it in godot-fun/gai, which has 183 GitHub stars. The repository holds 36 skills in this directory. The repository was last updated on October 10, 2026.

Source: godot-fun/gai on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.