Communitygithub.com

Akira-TL/akira-video-skills

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

akira-video-skills 是什么?

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

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Akira-TL/akira-video-skills/tree/HEAD/skills/video/video-shot

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

Video Shot

Each shot is the core work unit of video generation and editing. This skill owns video/shots/<shot-id>/SHOT.md but does not own model-specific prompt compilation or generation review conclusions.

Before expanding a set of shots from SHOTS.md, determine whether the scene needs a few observation points and whether establishing shots / reactions / inserts / product close-ups are genuinely useful, following references/planning/COVERAGE.md; do not mechanically apply a standard coverage package.

1. Establish Shot ID and Directory

By default use gap numbering, e.g., SC01_SH010, SC01_SH020; for simple projects without scene numbers, use SH010. When inserting shots in between, use legible intermediate numbers without renumbering the entire existing identity.

For complex projects, only add organizational directories (e.g., chapters) inside video/shots/ when flat layout has impaired browsing.

When a shot involves complex cinematography, action, cross-world transitions, or continuity, read references/direction/DIRECTION.md. When specific shot size, focal length/perspective, camera position, push/zoom, depth of field, focus, or product photography is needed, read references/direction/CAMERA-LANGUAGE.md first to define the visible photographic effect, then let the model adapter determine specific terminology. When multiple people touch, hand over objects, hand operations, product use, complex occlusions, or mechanical interactions are involved, read references/direction/INTERACTION.md to clarify the active action character, hands, contact points, and before/after states of the action. For multi-shot projects requiring validation of sequencing, dialogue, total duration, or product readability before expensive generation, references/planning/PREVIS.md allows lightweight animatics using storyboards and temporary audio; not every project requires this. For whether a shot must wait for the actual output of the previous shot, which shots can be parallelized, and how planned/actual handoffs work, see references/continuity/CONTINUITY-HANDOFF.md. When multi-character blocking, product/mechanical interaction, complex camera paths, first/last frame control, or spatial relationships between adjacent shots remain significantly uncertain before formal generation, read references/planning/PREVIS.md to perform minimal necessary previsualization/storyboarding.

2. Write SHOT.md

Complex shots or those to be externally generated can be written directly following references/planning/SHOT-TEMPLATE.md; simple shots keep only truly needed fields. When VIDEO.md explicitly requires multiple frame-aspect versions, read references/planning/MULTI-FORMAT.md to determine whether they can be cropped from the main version or require independent composition/generation.

SHOT.md only stores the current valid shot design, typically including:

  • Shot purpose;
  • Target duration (from current script / total duration budget, but still subject to the shot's actual action and dialogue);
  • Shot size, camera position, camera movement, and necessary focal length information;
  • Subject positioning, action, performance, and expression;
  • Environment and key props;
  • Dialogue, ambient sound, and shot-specific sound;
  • Continuity In / Continuity Out;
  • Assets currently referenced for reuse;
  • Hard constraints;
  • Generation notes allowing adjustments by the model adaptation layer.

Not every shot needs all fields. Keep simple shots concise.

3. Continuity

Continuity records only information truly relevant to adjacent shots, e.g., character position, costume, handheld objects, prop state, light direction, motion direction, and actions already performed.

If the actual generated output of the previous shot has acceptable deviations, the next shot continues from the actual visible state; if deviations violate character identity, product's real structure, or other hard constraints, that generated output must not be used as continuity reference.

4. Cinematography and Action

Camera movement must serve information, relationship, space, or emotion, not be mechanical movement for "cinematic feel." Video model action design should prioritize second-level temporal relationships; do not write frame-level control that can be accurately achieved only in post-production as hard model constraints.

A shot can have complex internal action, but must be clearly explainable why it is a single shot in the edit. When a model generates multiple cuts in a single pass, the project still organizes by final shot semantics; do not permanently merge multiple shots into one object because of model capability.

Boundaries for cropping, color grading, sound replacement, multi-aspect derivatives, and genuinely new shots of the same shot follow references/continuity/SHOT-DERIVATIVES.md; post-production derivatives must not overwrite takeNN.mp4 in the shot directory.

5. Pre-Generation Checklist

Before preparing a shot for video-generation, confirm:

  • Shot purpose is clear;
  • Target duration is compatible with the amount of action;
  • Reusable designs (character, scene, product, etc.) are determined;
  • Continuity In / Out are sufficiently clear for adjacent shots;
  • Reference asset responsibilities are clear;
  • Hard constraints and ordinary preferences have been distinguished;
  • Subtitles, logos, precise cut points, or other obvious post-production tasks are not mistakenly written as generation hard constraints.

If not satisfied, fix SHOT.md or upstream design first; do not substitute shot design with a "generate and see" approach.

6. Prompt and Generation Result Ownership

Long-term prompt versions and generation results live in the same directory as the shot:

prompt_v01.md prompt_v02.md take01.mp4 take02.mp4

Model-specific prompt compilation and one-shot generation packages are owned by video-generation; result selection, regeneration decisions, and post-production fixes are owned by video-review.

Completion Standard

SHOT.md is sufficient for the generation skill to compile prompts without re-guessing the director's intent, and clearly defines what the shot must inherit and what it leaves behind.

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

设计 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、视频人物表演定义、场景定义、对白或镜头总表时使用。

相关技能