Communitygithub.com

Akira-TL/akira-video-skills

Compiles and checks generation prompts for Runway's current video models; used when video-generation requires Runway (currently mainline Gen-4.5) for Text-to-Video or Image-to-Video, with Runway-specific motion, cinematography, and temporal expressions.

What is akira-video-skills?

This skill acts as a dedicated adapter layer for Runway's video generation models (e.g., Gen-4.5), ensuring prompts are optimized for the model's specific capabilities. It strictly follows the unified adapter contract defined by `video-generation`, focusing only on Runway-specific differences—such as model constraints, input types, and motion syntax. The skill avoids redefining shot goals (already defined in `SHOT.md`) and instead compiles existing creative intent into actionable prompts, while validating parameters like duration, aspect ratio, FPS, and resolution against official documentation. It supports both Text-to-Video (describing visuals and motion together) and Image-to-Video (focusing on movement and changes, avoiding redundant static description). Output is structured to return the finalized prompt, optional input images/references, and parameters for the generation UI, with long-term storage mapped to `prompt_vNN.md` files. It is designed for AI coding agents like Claude Code, Cursor, or Codex that orchestrate video generation workflows, improving prompt quality and reducing trial-and-error by aligning with Runway's current model behavior.

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

Ask in your favorite AI

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

Documentation

Video Model Runway

This Skill is the Runway model adapter layer. Before starting, follow the unified model adapter contract of the dependency video-generation; this file stores only Runway-specific differences. It is responsible solely for compiling already-defined material / SHOT.md creative intent into prompts that Runway's current model can execute more easily, and for verifying the actual input and duration capabilities of the selected Runway model; it does not redefine shot purpose, characters, plot, or product facts.

1. Fixed Specific Model and Generation Mode

First, clarify the actual Runway model and mode the user is using—for example, the current mainline Gen-4.5 for Text-to-Video or Image-to-Video.

If the user is using older Gen-4 / Gen-4 Turbo, Apps, Agent, Workflows, or other Runway tools, do not directly apply Gen-4.5's parameters; verify against current official documentation in references/MODEL-GUIDE.md.

Whenever precise duration, aspect ratio, frames per second (FPS), resolution, or input type is involved, always rely on the current official page.

2. Image to Video

When an input image already provides the subject, composition, lighting, and style, the prompt should primarily describe camera movement, subject motion, environmental motion, motion style, direction, speed, timing, and any changes that are genuinely needed for the current shot.

Do not repeat lengthy descriptions of static visual details already clearly expressed by the input image. Only add visual explanations when introducing new elements, obvious deformations, interactions, or changes to the starting frame.

Start with simple, direct motion descriptions by default, then add one major constraint based on failure patterns.

3. Text to Video

Without an input image, describe both visuals and motion simultaneously. A useful structure:

Cinematography / Composition → Subject → Action → Environment → Necessary Lighting / Style → Timing.

Not every item must appear. Preserve necessary creative freedom; avoid stacking contradictory long prompts just to be "complete."

4. Temporal Order

Complex actions may use natural language sequences or coarse timestamps. The time allocation must match the real time required by the action; do not break simple shots into overly dense instructions just to control every second.

5. Positive, Direct Descriptions

Prefer describing what should happen, rather than listing many negations. When a stationary camera is needed, write a clear positive state, e.g., "Lock the camera position; the camera remains still throughout the entire shot."

Hard constraints are still stored in SHOT.md; the final prompt retains only the expressions that the model truly needs to execute at that moment.

6. Return to video-generation

Output the current Runway prompt, suggested input image / reference, and parameters that need to be confirmed in the generation UI; long-term prompts are saved to the corresponding shot's prompt_vNN.md. When comparing multiple models in parallel, use clear model suffixes.

Packaging of one-shot generation bundles, file naming, and result importing are still handled by video-generation.

Completion Criteria

The prompt matches the specific Runway mode; Image-to-Video does not repeat descriptions of the input image, and Text-to-Video covers both necessary visuals and motion; precise capabilities are verified against current official documentation.

Individual skills in this repo

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

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

Akira-TL/akira-video-skills

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

Related Skills