Communitygithub.com

Akira-TL/akira-video-skills

Designs and maintains consistent character voices, timbre references, dialogue voice requirements, and their relationship to the overall audio across shots in AI video production. Use it when a character needs voice consistency across shots or when planning voice references, ambient sound, sound effects, music, and the boundaries of each with the visual.

What is akira-video-skills?

This skill, 'Video Audio', is responsible for sound design and cross-shot voice consistency in AI video production, without creating a separate project-level `audio/` directory. Long-term reusable sound assets are stored under `video/materials/`, such as character voice definitions and reference audio files, while shot-specific dialogue, breaths, and effects remain in `video/shots/<shot-id>/`. Full-music, voiceovers, and final mixing are handled in `video/edit/`. The skill distinguishes between three sound categories: character-long-term voices (maintaining stable age, gender, timbre, pitch, and speech habits across shots), shot-specific sounds (dialogue, footsteps, environmental changes unique to a shot), and film-wide audio (background music, narration, final mix managed by `video-editing`). It defines character voice designs with required attributes like vocal range, timbre, resonance, default tempo, and prohibited voice drift, and ensures that voice identity and emotion are treated separately—basic identity remains stable while reverb, spatial feel, and current emotion can change. Dialogue text ownership remains with `video-script`, while this skill focuses solely on voice performance and identity. When external voice generation is needed, it passes character definitions, current lines, and reference audio to `video-generation` without creating its own directory or temporary file rules. Final review checks for voice identity drift, lip-sync, tone, pitch, and timing, while overall music, mixing, subtitles, and final audio levels are handled by `video-editing`.

Works with~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Akira-TL/akira-video-skills/tree/HEAD/skills/video/video-audio

Ask in your favorite AI

Open a new chat with this agent skill pre-loaded.

Documentation

Video Audio

This Skill is responsible for sound design and cross-shot voice consistency in video production, but does not create a separate project-level audio/ directory.

Long-term reusable sound assets are stored under video/materials/, for example:

  • video/materials/voices/CHR01_voice.md
  • video/materials/voices/CHR01_reference.wav

Shot-specific dialogue, breaths, sound effects, or temporary sounds remain in the corresponding video/shots/<shot-id>/; full-film music, narration, mixing, and final sound engineering go into video/edit/.

For the complete sound layers and the boundaries between natively generated sounds and post-production sounds, see references/SOUND-LAYERS.md. When the video requires background music, brand/character motifs, animatic temp music, or AI-generated scoring, read references/MUSIC.md: temp and final music are clearly separated; music serves the story/dialogue/product and does not break character pacing just to hit beats. When a narrator, character inner voiceover, brand narration, or explanatory voice-over exists, read references/VOICEOVER.md: narration text belongs to video-script, voice identity/generation belongs to this Skill, and the final full-film narration goes into video/edit/.

1. First, Distinguish Three Types of Sounds

Character Long-Term Sounds

Requires stable age perception, gender presentation, vocal range, timbre, resonance, default speaking pace, volume, rhythm, and pronunciation/pause habits across shots.

Shot-Specific Sounds

Dialogue, breaths, sighs, shouts, footsteps, object collisions, and environmental changes that belong to a single shot; they are not copied to the public sound definition.

Film-Wide Sounds

Background music, full-film narration, overall sound design, and final mixing are managed by video-editing only during post-production.

2. Character Voice Design

When a character has dialogue across multiple shots, first create a voice definition, then generate or record specific lines. The character voice definition must clearly describe what the current project needs: age perception, basic vocal range, timbre, resonance, default tempo, default volume, speaking rhythm, pronunciation characteristics, variations under different emotions, and prohibited voice drift.

See the detailed template in references/VOICE-DESIGN.md.

3. Separate Voice Identity from Emotion

The same character can change reverb, environmental spatial feel, slight EQ, current emotion, and current speaking intensity across scenes and worlds, but the basic age perception, fundamental timbre, vocal range, pronunciation habits, and core rhythm should not change randomly.

If the generation tool provides speaker ID, voice reference, voice seed, speaker embedding, or equivalent stability mechanisms, prefer to reuse the same identity mechanism; the specific fields are determined by the current tool/model's official rules, and this Skill does not hard-code them.

4. Dialogue and The Visual

Dialogue length, visible lip-sync, multi-character speech, and cross-shot voice planning belong to video-script; if the current task requires this part, load that Skill as needed, or if missing, hand it back to akira-video to fill in, rather than copying script rules within this Skill. This Skill is only responsible for voice identity and the current voice performance.

Dialogue text continues to be owned by video-script; this Skill is only responsible for voice performance. When a video model that requires synchronized speech is used, compile dialogue, tone, pauses, and sound events into the generation prompt, but do not add lines that don't originally exist just to support the model's native sound capabilities.

5. Intentional Silence

If longer passages without dialogue are narrated by suspense, danger, music, visual climax, or action itself, the director's purpose for the silence should be clearly stated in the SHOT.md. If a character is actively operating for a long time without dialogue, reaction sounds, ambient sound, or music to carry the narrative, hand it back to video-shot to check if it's a dead section.

6. When External Voice Generation is Needed

Pass the character voice definition, current lines, reference audio, and return naming to video-generation, which organizes them according to the one-time generation package contract; this Skill does not create its own separate directory or temporary file rules.

7. Return for Review and Post-Production

  • Voice identity drift, lip-sync, tone, pitch, and timing are reviewed by video-review;
  • Shot-specific audio remains in the shot;
  • Full-film music, mixing, subtitles, and final audio levels are handled by video-editing.

Completion Criteria

Character voices can be stably recognized across shots; the responsibilities of shot sounds and full-film sounds are clear; no audio has been duplicated just for directory classification, and no tool-specific speaker parameters have been mistakenly written as general rules.

Individual skills in this repo

This repo contains 12 individual skills — each has its own dedicated page.

Akira-TL/akira-video-skills

为 Runway 当前视频模型编译和检查生成提示词;当 video-generation 需要使用 Runway(当前主线 Gen-4.5)的 Text to Video 或 Image to Video,并需要 Runway 专用动作、摄影和时序表达时使用。

Akira-TL/akira-video-skills

为 ByteDance / BytePlus Seedance 当前视频模型编译和检查提示词;当 video-generation 需要使用 Seedance 2.5 的参考素材、时间线、同步声音、视频编辑、延长或多镜头能力时使用。

Akira-TL/akira-video-skills

为 Google Veo 视频生成编译和检查提示词;当 video-generation 需要使用 Veo 的 Text to Video、Image to Video、首尾帧、参考元素或同步声音能力时使用,并先核验具体 Google 使用入口与 model 的当前支持范围。

Akira-TL/akira-video-skills

进入并持续推进一个 AI 视频制作项目;读取或建立 VIDEO.md,根据当前视频脚本、复用素材、镜头、生成结果和整片后期状态,按需路由到 canonical 视频专业 Skill,而不是把所有制作规则塞进一个总提示词。

Akira-TL/akira-video-skills

为品牌短片、产品植入剧情、广告或比赛作品建立产品事实与广告边界;当视频需要准确表达某个具体产品的官方功能、参数、结构、使用方式、品牌素材或产品与剧情关系时使用。

Akira-TL/akira-video-skills

设计 AI 视频中的角色与场景视觉方案;当脚本只说明“需要一个什么样的人/场景”,但还没有形成可稳定生成的外形、服装、材质、色彩、空间、光线和视觉识别系统时使用。

Akira-TL/akira-video-skills

组织整片级剪辑、合成、全片声音和最终成片;当多个已采用镜头需要进入 Premiere Pro、After Effects、DaVinci Resolve 等后期工程,或需要整片字幕、Logo、音乐、混音、比例版本和最终导出时使用。

Akira-TL/akira-video-skills

为 AI 图片或视频生成准备可直接使用的提示词与一次性生成包,并在用户把生成结果带回项目后归档;当需要从正式视频脚本、复用素材和 SHOT.md 编译生成内容、选择参考素材、约定返回文件名或清理临时包时使用。

Akira-TL/akira-video-skills

规划、创建、整理和维护多个镜头会重复使用的视频复用素材;当需要人物/场景/道具/产品提示词、参考图、官方素材、身份与状态参考或其他可重复引用内容时使用。

Akira-TL/akira-video-skills

审核 AI 生成的人物/场景等复用素材或镜头生成结果,判断采用、修改提示词、重生成还是留给后期修复;当生成结果返回项目、需要检查身份/结构/连续性/动作/摄影/产品真实性或选择生成结果时使用。

Akira-TL/akira-video-skills

把小说、章节、故事梗概、品牌 brief 或其他上游内容转换成当前视频自己的脚本层;当需要编写或修订 SCRIPT.md、视频人物表演定义、场景定义、对白或镜头总表时使用。

Akira-TL/akira-video-skills

把 SHOTS.md 中的镜头总览展开成可直接制作的单镜头定义;当需要创建或修改 video/shots/<shot-id>/SHOT.md、镜头连续性、摄影、动作、表演、声音或镜头专属生产约束时使用。

Related Skills