Communitygithub.com

Akira-TL/akira-video-skills

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

akira-video-skills 是什么?

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

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

在你喜欢的 AI 中提问

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

文档

Video Generation

This Skill is responsible for converting formal project content into executable AI generation inputs. The long-term sources remain video/script/, video/materials/, and video/shots/; disposable generation packs are merely derivative helpers for the user's external generation.

Before deciding how much content a single generation will cover and which generation method to use, read references/planning/GENERATION-STRATEGY.md. When generating a large batch of materials or shots, additionally read references/planning/BATCHING.md: first validate the baseline with high-risk representative samples, then expand the current parallel batch only after stabilization—do not prescribe a fixed batch size. When the existing video is mostly correct but needs continuous extension or generative local edits, additionally read references/transform/EDIT-EXTEND.md, first determining whether deterministic post-production or a new shot would actually be more appropriate.

1. Identify Generation Objects

Generation objects can be:

  • Reusable image assets (characters, scenes, props, products) used across multiple shots;
  • Video for a specific shot;
  • Shot-specific first frame, last frame, storyboard sketch/keyframe, supplementary images, or sound;
  • Long-term voice reference for a character, or whole-film music/narration draft.

First load the formal permanent content: reusable assets use the video-materials definitions, shot video uses the video-shot's SHOT.md. Do not reconstruct long-term facts from disposable packs or old chat history.

2. Write Long-Term Prompts

Before writing a generic video prompt for a shot, read references/prompting/VIDEO-PROMPT.md; if the current project has the corresponding model adapter installed, the adapter then compiles the generic shot intent into the final execution prompt for that model. All model adapters uniformly follow references/prompting/MODEL-ADAPTER-CONTRACT.md, specifying the exact endpoint/model/mode, current official capability verification, input mapping, execution settings, and unknowns. When the same shot needs to be tested in parallel across multiple models, additionally read references/prompting/MODEL-COMPARISON.md, keeping the same SHOT.md and consecutive generation result numbering without duplicating shot directories per model.

Prompts for reusable assets are saved in the corresponding video/materials/ directory; shot prompts are saved in the corresponding shot directory using a small number of explicit versions like prompt_v01.md, prompt_v02.md, etc.

Prompts should only compile the information the current generation model truly needs. Internal shot/asset definitions can be more complete than the final model prompt; model capabilities, fields, duration, and reference input limits are determined by the actually loaded model adapter Skill or official documentation—do not hardcode them in this Skill. Execution settings (model/endpoint, duration, aspect ratio, sound on/off) and boundaries with long-term project records follow references/prompting/EXECUTION-PARAMETERS.md.

If there are no reliable model-specific rules, remain generic, clear, and verifiable in describing visuals and actions, and inform the user that generic prompts are being used—do not fabricate specific model capabilities.

3. Select Reference Materials

Use the minimal sufficient reference set. Every reference must answer "What does it stabilize?": character identity, costume, scene, product structure, motion, cinematography, or another specific role.

Do not cram unrelated references into the same generation to avoid identity competition, style contamination, or product structure drift.

4. Organize Disposable Generation Packs

Before formal packaging, read references/planning/GENERATION-PACK.md, and follow it according to the dependency batch (image/sound/video pack), return naming, minimal reference set, import-back, and deletion boundaries; when the pack needs to be handed directly to the user, use references/planning/PACK-TEMPLATES.md to generate a self-contained task file. For project-level pack initialization, formal file copying, returns directory, status checks, zipping, and safe cleanup, prioritize reusing this Skill's built-in scripts/generation_pack.py; do not write ad-hoc packing scripts for each project. This CLI only handles the file lifecycle—it does not decide prompts, reference responsibilities, or review conclusions.

Create a descriptive directory under the project's .tmp/. The pack should remain simple by default:

.tmp/<generation-pack>/
├── README.md
├── <prompt files>
└── materials/

Only copy the prompts and reference materials needed for this specific generation batch. The README must at least specify:

  • The goal(s) of this generation;
  • Recommended generation order (if there are dependencies);
  • Which references each item uses;
  • Return filenames;
  • Hard constraints the user must explicitly check.

Image assets should use their corresponding long-term filenames upon return; before naming returned shot videos, use generation_pack.py next-take to query the next unused monotonically increasing takeNN for that shot—do not manually guess numbers or restart from take01 after switching models.

5. Import Results

After the user brings back generation results, first verify file correspondence, then place the formal results back into their respective permanent directories:

  • Reusable assets → video/materials/<category>/;
  • Shot results → video/shots/<shot-id>/;
  • Shot-specific sound/images → the same shot directory.

Only after video-review has explicitly accepted a returned file should you use generation_pack.py archive --confirm-reviewed to copy it to its permanent location; this action keeps the original file in returns/ and returns a SHA-256—do not overwrite existing permanent files. After all formal archival is complete and the temporary pack is confirmed to contain no unique information, use cleanup to delete the disposable generation pack.

6. Iteration Discipline

When generation fails, first determine whether the issue originates from:

  • Long-term assets/identity definitions;
  • The SHOT.md itself;
  • Prompt expression;
  • Model execution randomness;
  • Defects fixable through deterministic post-production.

A single retry should change only one major variable at a time. Do not rely on endlessly lengthening prompts as a substitute for problem diagnosis.

Completion Criteria

The pack the user receives is ready to execute the current generation task directly; return filenames are clear; the formal project remains the sole long-term source of truth; after results are archived, temporary packs can be safely deleted.

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

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

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、镜头连续性、摄影、动作、表演、声音或镜头专属生产约束时使用。

相关技能